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PREFACE 


This  product  specification  covers  the  work  performed  under 
Air  Force  Contract  F33615-80-C-5155  (ICAM  Project  6201).  This 
contract  is  sponsored  by  the  Materials  Laboratory.  Air  Force 
Systems  Command.  Wr ight-Patterson  Air  Force  Base.  Ohio.  It  was 
administered  under  the  technical  direction  of  Mr.  Gerald  C. 
Shumaker.  ICAM  Program  Manager.  Manufacturing  Technology 
Division,  through  Project  Manager.  Mr.  David  Judson.  The  Prime 
Contractor  was  Production  Resources  Consulting  of  the  General 
Electric  Company,  Schenectady,  New  Tork,  under  the  direction  of 
Mr.  Alan  Rubenstein.  The  General  Electric  Project  Manager  was 
Mr.  Myron  Hurlbut  of  Industrial  Automation  Systems  Department, 
Albany.  New  York. 

Certain  work  aimed  at  improving  Test  Bed  Technology  has 
been  performed  by  other  contracts  with  Project  6201  performing 
integrating  functions.  This  work  consisted  of  enhancements  to 
Test  Bed  software  and  establishment  and  operation  of  Test  Bed 
hardware  and  communications  for  developers  and  other  users. 
Documentation  relating  to  the  Test  Bed  from  all  of  these 
contractors  and  projects  have  been  integrated  under  Project  6201 
for  publication  and  treatment  as  an  integrated  set  of  documents. 
The  particular  contributors  to  each  document  are  noted  on  the 
Report  Documentation  Page  (DD1473).  A  listing  and  description 
of  the  entire  project  documentation  system  and  how  they  are 
related  is  contained  in  document  FTR620100001 .  Project  Overview. 

The  subcontractors  and  their  contributing  activities  were 
as  follows: 


TASK  4.2 

Subcontractors 

Boeing  Military  Aircraft 
Company  ( BMAC ) 

D.  Appleton  Company 
( DACOM ) 


General  Dynamics/ 
Ft .  Worth 


P.ole 


Reviewer 


Responsible  for  IDEF  support 
state-of-the-art  literature 
search 

Responsible  for  factory  view 
function  and  information 
model s 


riiri- 
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Role 


Subcontractors 

Illinois  Institute  of 
Techno 1 ogy 

North  American  Rockwell 
Northrop  Corporation 

Pritsker  and  Associates 
SofTech 

TASKS  4.3  -  4.9  (TEST  BED) 

Subcontractors 

Boeing  Military  Aircraft 
Company  ( BMAC ) 

Computer  Technology 
Associates  (CTA) 

Control  Data  Corporation 
( CDC ) 


D.  Appleton  Company 
( DACOM ) 


Responsible  for  factory  view 
function  research  (IITRI) 
and  information  models  of 
small  and  medium-sise  business 


Responsible  for  factory  view 
function  and  information 
models 

Responsible  for  IDEF2  support 
Responsible  for  IDEFO  support 


Responsible  for  consultation  on 
applications  of  the  technology 
and  on  IBM  computer  technology. 

Assisted  in  the  areas  of 
communications  systems,  system 
design  and  integration 
methodology,  and  design  of  the 
Network  Transaction  Manager 

Responsible  for  the  Common  Data 
Model  (COM)  implementation  and 
part  of  the  CDM  design  (shared 
with  DACOM) 

Responsible  for  the  overall  CDM 
Subsystem  design  integration 
and  test  plan,  as  well  as  part 
of  the  design  of  the  CDM 
(shared  with  CDC)  DACOM  also 
developed  the  Integration 
Methodology  and  did  the  schema 
mappings  for  the  Application 
Subsystems 


Reviewer 


Role 
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Subcontractors 


Role 


Digital  Equipment 
Corporation  (DEC) 


McDonne 1 1  Doug las 
Automation  Company 
(McAuto) 


On-Line  Software 
International  (OSI) 


Consulting  and  support  of  the 
performance  testing  and  on  DEC 
software  and  computer  systems 
operation. 

Responsible  for  the  support  and 
enhancements  to  the  Network 
Transaction  Manager  Subsystem 
during  1984/1985  period. 

Responsible  for  programming  the 
Communications  Subsystem  on  the 
IBM  and  for  consulting  on  the 
IBM. 


Rath  and  Strong  Systems 
Products  ( RSSP )  (In  1985 
became  McCormack  &  Dodge) 


SofTech,  Inc. 


Software  Performance 
Engineering  (SPE) 


Structural  Dynamics 
Research  Corporation 
( SDRC ) 


Responsible  for  assistance  in 
the  implementation  and  use  of 
the  MRP  II  package  (PIOS)  that 
they  supplied. 

Responsible  for  the  design  and 
implementation  of  the  Network 
Transaction  Manager  (NTM)  in 
1981/1984  period. 

Responsible  for  directing  the 
work  on  performance  evaluation 
and  analysis. 

Responsible  for  the  User 
Interface  and  Virtual  Terminal 
Interface  Subsystems. 


Prime  contractors  under  other  projects  who  have  contributed 
to  Test  Bed  Technology,  their  contributing  activities  and 
responsible  projects  are  as  follows: 


Contractors 


ICAM  Project  Contributing  Activities 


Boeing  Military 
Aircraft  Company 
( BMAC ) 


1701 .  2201 .  Enhancements  for  IBM 
2202  node  use.  Technology 

Transfer  to  Integrated 
Sheet  Metal  Center 
( I SMC) 
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Contractors 

ICAM  Pro.iect 

Contributing  Activities 

Control  Data 
Corporation  (CDC) 

1502,  1701 

IISS  enhancements  to 
Common  Data  Model 
Processor  (CDMP) 

D.  Appleton  Company 
( DACOM ) 

1502 

IISS  enhancements  to 
Integration  Methodology 

General  Electric 

1502 

Operation  of  the  Test 
Bed  and  communications 
equipment . 

Hughes  Aircraft 

Company  ( HAC ) 

1701 

Test  Bed  enhancements 

Structural  Dynamics 
Research  Corporation 
(SDRC) 

1502,  1701, 
1703 

IISS  enhancements  to 
User  Interface/Virtual 
Terminal  Interface 
(UI/VTI) 

Systran 

1502 

Test  Bed  enhancements. 
Operation  of  Test  Bed. 
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SECTION  1 


SCOPE 


1 . 1  Ident i f i cat i on 

This  specification  establishes  the  detailed  design  of  a 
collection  of  form-based  applications  identified  as  the  User 
Interface  Services,  hereinafter  referred  to  as  UIS.  The  UIS  is 
one  configuration  item  of  the  Integrated  Information  Support 
System  (IISS)  User  Interface  (UI). 

1.2  Functional  Summary 


The  UIS  is  a  collection  of  applications  that  use  the  Form 
Processor.  Each  application  is  individually  accessed  by  filling 
its  name  in  the  function  item  on  the  IISS  Function  Screen.  Each 
application  presents  a  form  to  the  user  which  must  be  filled  in 
with  information  for  processing  by  that  application.  The 
application  then  communicates  with  the  Form  Processor  through 
messages  created  and  sent  by  the  Application  Interface  and 
handled  by  the  UIM  (User  Interface  Monitor)  of  the  Form 
Processor . 
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SECTION  2 
DOCUMENTS 


2.1  Reference  Documents 


[1]  Structural  Dynamics  Research  Corporation,  Appl i cat ion 
Interface  Product  Specification,  PS  620144700  ,  1 
November  1985. 

[2]  Structural  Dynamics  Research  Corporation,  Forms 
Dr i ven  Form  Editor  Product  Specification, 

PS  620144402  ,  1  November  1985. 

[3]  Structural  Dynamics  Research  Corporation,  Forms 
Language  Compiler  Product  Specification, 

PS  620144401  ,  1  November  1985. 

[4]  Structural  Dynamics  Research  Corporation,  Form 
Processor  Product  Specification,  PS  620144200  , 

1  November  1985 . 

[5]  Structural  Dynamics  Research  Corporation,  Rapid 
Appl i cat ion  Generator  Product  Specification , 

PS  620144502  ,  1  November  1985. 

[6]  Structural  Dynamics  Research  Corporation,  Report 
Wr i ter  Product  Specification,  PS  620144501  , 

1  November  1985 . 

[7]  Structural  Dynamics  Research  Corporation,  Text 
Editor  Product  Specification,  PS  620144600  , 

1  November  1985 . 

[9]  Structural  Dynamics  Research  Corporation,  Virtual 
Terminal  Product  Specification ,  PS  620144300  , 

1  September  1985 . 

[10]  Structural  Dynamics  Research  Corporation,  User 
Interface  Services  Development  Specification, 

DS  620144100B ,  1  November  1985. 

[12]  Structural  Dynamics  Research  Corporation,  User 

Interface  Services  Unit  Test  Plan,  UTP620144100  , 
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[13]  Structural  Dynamics  REsearch  Corporation,  IISS 

Terminal  Operator  Guide ,  OM  620144000  ,  1  November 
1985  . 

2 . 2  Terms  and  Abbreviations 

Appl i cat  ion  Interface :  (AI),  subset  of  the  IISS  User 
Interface  that  consists  of  the  callable  routines  that  are  linked 
with  applications  that  use  the  Form  Processor  or  Virtual 
Terminal.  The  AI  enables  applications  to  be  hosted  on  computers 
other  than  the  host  of  the  User  Interface. 

Appl i cat  ion  Process :  (AP),  a  cohesive  unit  of  software  that 
can  be  initiated  as  a  unit  to  perform  some  function  or 
f unct i ons . 

Form :  structured  view  which  may  be  imposed  on  windows  or 
other  forms.  A  form  is  composed  of  fields.  These  fields  may  be 
defined  as  forms,  items,  and  windows. 

Form  Definition:  (FD),  forms  definition  language  after 
compilation.  It  is  read  at  runtime  by  the  Form  Processor. 

Forms  Definition  Language :  (FDL),  the  language  in  which 
electronic  forms  are  defined. 

Forms  Driven  Form  Editor :  ( FDFE ) ,  subset  of  the  FE  which 
consists  of  a  forms  driven  application  used  to  create  Form 
Definition  files  interactively. 

Form  Editor :  (FE),  subset  of  the  IISS  User  Interface  that 
is  used  to  create  definitions  of  forms.  The  FE  consists  of  the 
Forms  Driven  Form  Editor  and  the  Forms  Language  Compiler. 

Forms  Language  Compiler:  (FLAN),  subset  of  the  FE  that 
consists  of  a  batch  process  that  accepts  a  series  of  forms 
definition  language  statements  and  produces  form  definition 
files  as  output . 

Form  Processor :  (FP),  subset  of  the  IISS  User  Interface 
that  consists  of  a  set  of  callable  execution  time  routines 
available  to  an  application  program  for  form  processing. 

I_ISS  Funct i on  Screen :  the  first  screen  that  is  displayed 
after  logon.  It  allows  the  user  to  specify  the  function  he 
wants  to  access  and  the  device  type  and  device  name  on  which  he 
is  working. 
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Integrated  Information  Support  System :  (IISS).  a  test 
computing  environment  used  to  investigate,  demonstrate  and  test 
the  concepts  of  information  management  and  information 
integration  in  the  context  of  Aerospace  Manufacturing.  The  IISS 
addresses  the  problems  of  integration  of  data  resident  on 
heterogeneous  data  bases  supported  by  heterogeneous  computers 
interconnected  via  a  Local  Area  Network. 

Presentation  Schema :  (PS),  may  be  equivalent  to  a  form.  It 
is  the  view  presented  to  the  user  of  the  application. 

User  Data :  data  which  is  either  input  by  the  user  or 
output  by  the  application  programs  to  items. 

User  Interface :  (UI),  IISS  subsystem  that  controls  the 
user's  terminal  and  interfaces  with  the  rest  of  the  system.  The 
UI  consists  of  two  major  subsystems:  the  User  Interface 
Development  System  (UIDS)  and  the  User  Interface  Management 
System  (UIMS). 

User  Interface  Development  System:  (UIDS),  collection  of 
IISS  User  Interface  subsystems  that  are  used  by  applications 
programmers  as  they  develop  IISS  applications.  The  UIDS 
includes  the  Form  Editor  and  the  Application  Generator. 

User  Interface  Management  System :  (UIMS),  the  runtime  UI . 

It  consists  of  the  Form  Processor,  Virtual  Terminal,  Application 
Interface,  the  User  Interface  Services  and  the  Text  Editor. 

User  Interface  Services :  (UIS),  subset  of  the  IISS  User 
Interface  that  consists  of  a  package  of  routines  that  aid  users 
in  controlling  their  environment.  It  includes  message 
management,  change  password,  and  application  definition 
services . 

User  Interface/ Virtual  Terminal  Interface :  (UI/VTI), 
another  name  for  the  User  Interface. 

V i rtual  Terminal :  (VT),  subset  of  the  IISS  User  Interface 
that  performs  the  interfacing  between  different  terminals  and 
the  UI .  This  is  done  by  defining  a  specific  set  of  terminal 
features  and  protocols  which  must  be  supported  by  the  UI 
software  which  constitutes  the  virtual  terminal  definition. 
Specific  terminals  are  then  mapped  against  the  virtual  terminal 
software  by  specific  software  modules  written  for  each  type  of 
real  terminal  supported. 
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W i ndow :  dynamic  area  of  a  terminal  screen  on  which 
predefined  forms  may  be  placed  at  run  time. 

Window  Manager :  a  facility  which  allows  the  following  to  be 
manipulated:  size  and  location  of  windows,  the  device  on  which 
an  application  is  running,  the  position  of  a  form  within  a 
window.  It  is  part  of  the  Form  Processor. 


•  • -V 
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SECTION  3 


REQUIREMENTS 


3 . 1  Structural  Description 

The  UIS  consists  of  independent  IISS  programs  which  may  be 
invoked  from  the  IISS  Function  Screen.  The  UIS  provides  the 
following  independent  applications: 

1)  Define  Application 

2)  Change  Password 

3)  Message  Management 

3.1.1  Define  Application 

The  following  figure  shows  the  basic  architecture  of  the 
Define  Application  application: 


i  Define  Application 


i  Get  Application' 
i  Description  i 


i  Define  New  i 
i  Application  I 


i  Update/Delete i 
i  Application  i 


Figure  3 


Basic  Architecture  of  Define  Application 
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3.1.2  Change  Password 

This  application  consists  of  two  modules.  The  main  module 
processes  the  application  form.  It  retrieves  the  data  from  the 
form  and  verifies  the  input.  Upon  successful  verification  of 
password  information,  it  calls  the  second  module  to  update  the 
user's  entry  in  the  UIUSER  table.  After  update,  it  informs  the 
user  of  the  success  of  the  update. 

3.1.3  Message  Management 

In  the  VAX  environment,  the  files  that  are  updated  are 
located  in  the  directory  pointed  to  by  the  logical  IISSMLIB  and 
have  the  format  MSGXXX . MSG  where  XXX  is  the  message  base  number 
A  new  version  of  the  MSGXXX. MSG  file  is  created  every  time  a  new 
base  number  is  chosen  or  an  existing  base  number  is  updated. 
These  message  files  should  be  purged  so  that  several  versions  of 
the  same  file  do  not  exist. 

The  record  format  of  the  MSGXXX . MSG  file  is  the  message 
number  followed  by  the  message  name  and  then  the  message 
description  These  files  may  then  be  used  as  input  to  a  program 
called  INCGEN  This  program  produces  an  include  file  in  the 
language  specified  when  the  INCGEN  program  was  executed  The 
include  files  can  be  generated  in  C.  Cobol .  PLI ,  or  Fortran 
The  include  file  may  then  be  used  in  the  application  for  which 
this  message  base  was  defined 

3  2  Functional  Flow 


3  2  1  Define  Application 


Figure  32  if  a  data  flow  diagram  of  Define  Application 


sa. 


Ay 


A 
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3.2.3  Message  Management 


Figure  3-4  is  a  data  flow  for  Message  Management. 


Figure  3-4  Message  Management  Data  Flow 
3.2.3. 1  INCGEN 

Figure  3-5  is  a  data  flow  diagram  for  INCGEN. 


I 


Figure  3-5  IMOGEN  Data  Flow 
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3 . 3  Interfaces 
3.3.1  Form  Processor 


Define  Application,  Change  Password  and  Message  Management 
interface  with  the  Form  Processor  through  calls  to  the 
Application  Interface  (AI).  The  AI  routines  translate  the 
application  request  into  the  NTM  message  format  and  then  send 
the  message  that  contains  the  application  request  data  to  the 
User  Interface  Monitor. 

3.3.2  UIM 


The  UIM,  which  is  the  main  control  program  for  the  Form 
Processor,  calls  the  appropriate  FP  routine  when  a  message  is 
received  from  a  UIS  application.  The  UIM  then  returns  the 
output  parameters  to  the  UIS  application. 

3.3.3  NTM 


The  UIS  applications  must  use  the  NTM  initialization 
routine,  INITAL  and  the  NTM  termination  routine,  TRMNAT . 

3 .4  Program  Interrupts 

This  section  does  not  apply  to  the  detailed  design  of  the 
User  Interface  Service  applications. 

3 . 5  Timing  and  Sequencing  Description 

The  UIS  applications  are  initiated  through  the  IISS 
Function  Screen  presented  to  the  user  after  logging  on  correctly 
to  the  IISS.  Each  application  accepts  input  from  and  returns 
output  to  the  user's  terminal  via  application  defined  forms. 

Specific  functions  within  the  User  Interface  Services 
permit  the  user  to  create,  maintain  and  delete  commands  which 
are  used  to  run  application  programs.  Utility  functions  also 
exist  for  changing  the  users  password  and  for  managing  error 
messages  for  application  development 

3  6  Special  Control  Features 

The  detailed  design  of  the  User  Interface  Services  does  not 
include  any  special  control  features  as  defined  in  the  ICAM 
Documentation  Standards  manual 
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3.7  Storage  Allocation 


The  executable  sizes  for  Define  Application,  Change 
Password.  Message  Management  and  INCGEN  are: 


Define  Application 
Change  Password 
Message  Management 
INCGEN 


268  blocks 
237  blocks 
130  blocks 
65  blocks 


3.7.1  Data  Base  Definition 


3. 7. 1.1  File  Descriptions 


The  following  files  are  used  by  the  Message  Management 
appl i cat ion . 


1.  FILENAME:  MSGxxx.MSG 


PURPOSE:  This  file  contains  message  codes  and  descriptions 

used  by  the  FP  routine  PMSGLC.  The  XXX  in  the  name  of  the 
file  corresponds  to  the  first  three  numbers  in  the  message 
codes . 


DECLARATION : 

typdef  struct 
{ 

char  number [5]; 
char  name [ 8 ] ; 
char  descrip[60] ; 

1  MSGLIN 

2  FILE  NAME:  user  specified 

PURPOSE:  This  file  is  generated  by  the  program  INCGEN.  It  is 
used  by  application  programs  that  call  the  FP  routine  PMSGLC 
It  enables  application  code  to  be  independent  of  the  message 
code  values  sine  it  provides  variable  names  for  the  values. 
This  file  may  be  generated  in  COBOL.  Fortran,  C,  or  PLI . 
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DECLARATION : 

The  following  is  a  sample  include  file  generated  by  INCGEN: 


01 

OK 

PIC 

x(5) 

VALUE 

' 70000 ' 

01 

FPMSGS 

PIC 

X(5) 

VALUE 

' 70300 ' 

01 

INVPAG 

PIC 

X(  5  ) 

VALUE 

'70301 ' 

01 

FNOTFND 

PIC 

X(  5  ) 

VALUE 

' 70302 ' 

01 

F ISOPEN 

PIC 

X(  5  ) 

VALUE 

' 70303 ' 

01 

ALCERR 

PIC 

X(  5  ) 

VALUE 

' 70304 ' 

01 

OPNERR 

PIC 

X(  5  ) 

VALUE 

' 70305 ' 

01 

EXPERR 

PIC 

X(  5  ) 

VALUE 

' 70306 ' 

01 

TRNCFLD 

PIC 

X(  5  ) 

VALUE 

' 70307 ' 

01 

UNKTYPE 

PIC 

X(  5  ) 

VALUE 

' 70308 ' 

01 

PNOTARY 

PIC 

X(  5  ) 

VALUE 

' 70309 ' 

01 

NILKEY 

PIC 

X(  5  ) 

VALUE 

'70310' 

01 

SYSERR 

PIC 

X(  5  ) 

VALUE 

'70311 ' 

01 

PBFULL 

PIC 

X(5) 

VALUE 

'70312' 

01 

INVEDT 

PIC 

X(  5  ) 

VALUE 

'70313' 

01 

FILRERR 

PIC 

X(  5  ) 

VALUE 

'70314' 

01 

PATHERR 

PIC 

X(  5  ) 

VALUE 

'70315' 

01 

NOMACH 

PIC 

XC5) 

VALUE 

'70316' 

01 

PNOTFND 

PIC 

X(  5  ) 

VALUE 

'70317' 

01 

VRDWRAP 

PIC 

X(  5  ) 

VALUE 

'70318 

01 

INVMRG 

PIC 

X(  5  ) 

VALUE 

'70319' 

01 

PNOTUNQ 

PIC 

X(  5  ) 

VALUE 

'70320 

3 . 7 . 1 . 2  Tabl e  Description 

Only  the  Define  Application  and  the  Change  Password  UIS 
applications  use  the  relational  database  management  system 
ORACLE.  The  Message  Management  UIS  application  uses  VAX  files. 
The  following  table  descriptions  show  the  ORACLE  database.  Some 
of  these  tables  are  used  by  the  UIM  of  the  Form  Processor.  For 
completeness  and  to  show  the  relationships  between  the  tables 
and  views,  all  have  been  presented  here. 

The  data  base  contains  four  tables  and  two  views. 

M)  UIUSER  contains  information  about  users. 

(.  )  APPL  contains  information  about  applications. 

(3)  USEROL  relates  users  to  roles. 

(4)  ROLAPP  relates  roles  to  applications 
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(5)  ROLAPT  is  a  view  relating  roles  to  application 
information.  It  is  used  to  retrieve  information  for 
the  HELP  form. 

(6)  LOGON  is  a  view  relating  user  information  to  roles, 
is  used  to  verify  logon  data. 

.2.1  Relationship  Between  Tables  and  Views 


The  following  illustrates  the  relationship  between  the 
various  tables  and  views.  The  symbol  <-->  indicates  that  two 
columns  contain  the  same  type  of  data.  The  symbol  *  denotes  key 
fields.  Names  enclosed  in  parentheses  are  the  names  of  tables 
from  which  data  is  actually  retrieved. 

TABLES 


UIUSER 


USEROL 


ROLAPP 


APPL 


USERID 
NAME 
PS WORD 


*  USERID 

*  ROLE 


*  ROLE 
»  APPLID 


*  APPLID 
DESCRP 
TYP 
HOST 
WKSTAT 
C0M1 
COM2 


VIEWS 


COM  10 


ROLAPT 

ROLE  (ROLAPP) 
APPLID  (ROLAPP) 
DESCRP  (APPL) 
TYP  (APPL) 


LOGON 

USERID  (USEROL) 
ROLE  ( USEROL ) 
PSWORD  (UIUSER) 


3.7  1.2.2  Detail  led  Description  of  Tables  and  Views 

The  following  figure  is  a  detailed  description  of  the 
tables  and  views  outlined  in  the  previous  section.  The  heading 
descriptions  are  as  follows: 
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(1)  CNAME  -  column  name 

(2)  TNAME  -  table  or  view  name 

(3)  CREATOR  ■  creator  of  table  or  view 

(4)  COLNO  -  column  number 

(5)  COLTYP  -  column  data  type 

(6)  WIDTH  -  width  of  column 

(7)  SCALE  -  scale 

(8)  NULLS  -  whether  or  not  a  column  may  contai 

nulls 
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1 

1 

1 

CNAME 

1 

1 

1 

TNAME 

1 

1  CREATOR 

1 

1 

ICOLNO 

1 

1 

ICOLTYP 

1 

1  1 

WIDTH  1  SCALE  1  NULLS 

1  1 

1 

1 

1 

1 

1 

APPLID 

1 

1 

APPL 

1 

1 

FORMS 

1 

1 

1 

1 

1  CHAR 

10  1 

1 

1  NULL 

1 

1 

1 

DESCRP 

1 

APPL 

1 

FORMS 

1 

2 

1  CHAR 

25  1 

1  NULL 

1 

1 

TYP 

1 

APPL 

1 

FORMS 

1 

3 

1  CHAR 

1  1 

1  NULL 

1 

1 

HOST 

1 

APPL 

1 

FORMS 

I 

4 

1  CHAR 

5  1 

1  NULL 

1 

1 

WKSTAT 

1 

APPL 

1 

FORMS 

1 

5 

1  CHAR 

5  1 

1  NULL 

1 

1 

C0M1 

i 

APPL 

1 

FORMS 

1 

6 

1  CHAR 

80  1 

1  NULL 

1 

1 

COM2 

l 

APPL 

1 

FORMS 

i 

7 

1  CHAR 

80  1 

1  NULL 

1 

1 

COM3 

1 

APPL 

1 

FORMS 

1 

8 

i  CHAR 

80  1 

1  NULL 

1 

1 

COM4 

l 

APPL 

1 

FORMS 

1 

9 

1  CHAR 

80  1 

1  NULL 

1 

1 

COM  5 

1 

APPL 

l 

FORMS 

1 

10 

1  CHAR 

80  1 

1  NULL 

1 

1 

C0M6 

1 

APPL 

l 

FORMS 

1 

11 

1  CHAR 

80  1 

1  NULL 

1 

1 

COM7 

1 

APPL 

1 

FORMS 

1 

12 

1  CHAR 

80  1 

1  NULL 

1 

1 

COM  8 

1 

APPL 

1 

FORMS 

1 

13 

1  CHAR 

80  1 

1  NULL 

1 

1 

C0M9 

1 

APPL 

1 

FORMS 

1 

14 

1  CHAR 

80  1 

1  NULL 

1 

1 

COM  10 

1 

APPL 

1 

FORMS 

1 

15 

1  CHAR 

80  1 

1  NULL 

1 

1 

ROLE 

1 

ROLAPP 

1 

FORMS 

1 

1 

1  CHAR 

10  1 

1  NULL 

1 

1 

APPLID 

1 

ROLAPP 

1 

FORMS 

1 

2 

1  CHAR 

10  1 

1  NULL 

1 

1 

USERID 

1 

UIUSER 

1 

FORMS 

1 

1 

1  CHAR 

10  1 

1  NULL 

1 

1 

NAME 

1 

UIUSER 

1 

FORMS 

1 

2 

1  CHAR 

30  1 

1  NULL 

1 

1 

P SWORD 

1 

UIUSER 

1 

FORMS 

1 

3 

1  CHAR 

10  1 

1  NULL 

1 

! 

USERID 

1 

USEROL 

1 

FORMS 

1 

1 

1  CHAR 

10  l 

1  NULL 

1 

1 

ROLE 

1 

USEROL 

l 

FORMS 

1 

2 

l  CHAR 

10  1 

l  NULL 

1 

1 

ROLE 

l 

ROLAPT 

1 

FORMS 

1 

1 

1  CHAR 

10  1 

1  NULL 

1 

1 

APPLID 

i 

ROLAPT 

l 

FORMS 

1 

2 

1  CHAR 

10  1 

1  NULL 

1 

1 

DESCRP 

1 

ROLAPT 

1 

FORMS 

1 

3 

1  CHAR 

25  1 

1  NULL 

1 

1 

TYP 

1 

ROLAPT 

1 

FORMS 

1 

4 

1  CHAR 

1  I 

1  NULL 

1 

1 

USERID 

1 

LOGON 

1 

FORMS 

1 

1 

1  CHAR 

10  l 

1  NULL 

1 

1 

ROLE 

l 

LOGON 

i 

FORMS 

1 

2 

1  CHAR 

10  1 

1  NULL 

1 

1 

1 

PSWORD 

t 

1 

LOGON 

1 

1 

FORMS 

1 

1 

3 

1  CHAR 

1 

10  1 

1  NULL 

1 

1 

1 

Figure  3-6  Table  and  View  Description 
3 . 8  Object  Code  Creation 

The  UIS  application  routines  were  compiled  with  an  ANSI 
COBOL  compiler  under  VAX/VMS.  The  source  is  portable  to  other 
compilers  on  machines  such  as  the  IBM. 


PS  620144100 
1  November  1985 


3.9  Adaptation  Data 

The  UIS  application  source  is  portable  to  other  ANSI  COBOL 
compilers . 

3.10  Detailed  Design  Description 


3.10.1  Main  Program  List 

The  following  is  a  list  of  all  "Main  Programs"  which 
are  modules  that  are  not  called  by  any  other  module  being 
documented  here.  These  modules  are  either  program  entry  points 
or,  if  they  are  hooked  into  another  set  of  programs  via 
subroutine  calls,  they  are  the  points  the  external  programs  can 
call  and  therefore  enter  through.  To  differentiate  between  the 
two  types  of  entry  points,  look  at  the  individual  Module 
Documentation  (section  3.10.8)  and  look  at  Module  Type  for  each 
of  the  Main  Program  modules  listed.  Note  whether  the  routine 
is  a  Program,  Subroutine,  or  Function.  If  it  is  a  Program,  it 
is  truly  a  main  program  entry  point.  If  not,  then  it  is  merely 
called  by  other  programs  not  being  documented  here. 
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UI  SERVICES  Main  Program  List 


Module  Name 

Purpose 

DBCUPR 

CHECK  USERID-PASSWORD-ROLE  COMBINATION 

DBGAPP 

Get  Applications 

INCGEN/MAIN 

MAIN  MODULE  FOR  INCLUDE 

FILE  GENERATOR 

MM/MAIN 

MAIN  MODULE  FOR  MESSAGE 

MANAGEMENT 

PROCAP 

PROCess  Application 

PROCDF 

PROCess  DeFine  form 

PROCPW 

PROCESS  PS WORD  FORM 
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3.10.2  Module  List 

The  following  is  a  list  of  all  the  modules  being 
documented  here  along  with  their  purpose.  Each  module  has  a 
unique  name ,  no  matter  what  language  it  was  written  in. 


UI  SERVICES  Module  List 
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Module  Name 


Purpose 


DBCLSE 


DBCOM 


CLOSE  DATA  BASE 


COMMIT  DATA  BASE 


DBCUPR 


CHECK  USERID-PASSWORD-ROLE  COMBINATION 


DBDAPP 


Delete  Application 


DBDAPR 


Delete  APpRo 1 


DBGAPD 


Get  Application  Description 


DBGAPP 


Get  Applications 


DBIAPD 


Insert  Application  Description 


DBOPEN 


OPEN  DATA  BASE 


DBROLL 


ROLL  BACK  DATA  BASE 


DBUAPD 


Update  Application  Description 


DBUPW 


UPDATE  PASSWORD 


INCGEN/MAIN 


MAIN  MODULE  FOR  INCLUDE  FILE  GENERATOR 


MM/MAIN 


MAIN  MODULE  FOR  MESSAGE  MANAGEMENT 


MM/NEWFILE 


SAVE  MESSAGES  IN  A  NEW  FILE 


MM/SAVEIT 


SAVE  MESAGE  FILE  CHANGES 


PROCAP 


PROCess  Application 


PROCDC 


PROCess  Define  Command  form 


PROCDF 


PROCess  DeFine  form 


PROCPW 


PROCESS  PSWORD  FORM 


PROCUC 


PROCess  Update  Command  form 


3-14 


vvvv*. 
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3.10.3  External  Routines  List 

The  following  is  a  list  of  all  routines  or  functions  not 
documented  here  that  are  called  by  modules  that  are  documented 
here.  The  first  caller,  in  alphabetical  order,  is  listed  as 
well.  The  specification  in  which  any  module  is  documented  may 
be  found  in  the  Module  Documentation  Index  (Document  Humber 
CM  620100001).  See  section  3.10.6  for  a  list  of  the  modules 
that  call  each  of  these  external  routines. 
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UI  SERVICES  External  Routines  List 


Module  Name 

First  User 

ADDFRM 

P ROC DC 

CLSFRM 

PROCDF 

FCLOSE 

MM  NEWFILE 

FEOF 

INCGEM  MAIN 

FOPEN 

IMOGEN  HAIM 

FPRINTF 

INCGEN  MAIN 

FREAD 

IMOGEN  MAIN 

FWRITE 

MM  SAVEIT 

GDATA 

P  ROC  DC 

GETCHAR 

INCGEN  MAIN 

GETS 

INCGEN  MAIN 

GPAGE 

PROCDF 

INITAL 

PROCDF 

INITFP 

MM  MAIN 

MEMCMP 

MM  MAIN 

MEMCPY 

MM  MAIN 

MEMSET 

MM  NEWFILE 

OBINL 

DBUPW 

DOOM 

DBCOM 

OOF  INN 

DBGAPD 

OEXEC 

DBGAPP 

OF ETCH 

DBG A  P  P 

0  I  SCR 

MM  MAIN 

logo  f 

DBCLSE 

L  aj  N 

DBOPEN 

1  xiPEN 

DBOPEN 

OPNFRM 

MM  MAIN 

GkuL 

DBROLL 

-VL  ’ 

DBDAPP 

p:  at  a 

PROCUC 

PMSGLS 

PROCPW 

PR  1  NT! 

INCGEN  MAIN 

R  M  V  P  A  < . 

PROCDF 

5  PR  I  NT! 

MM  NEWFILE 

TKRHr } 

PROCDF 

TRMNAT 

PROOPW 
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3  10  4  Include  File  List 

The  following  is  a  list  of  all  include  files  called  in 
by  modules  being  documented  here  Each  include  file  has  a 
unique  name  regardless  of  the  language  being  used  The  purpose 
of  each  include  file  is  listed  as  wel 1  A  more  complete 
description  of  each  include  file  is  given  in  section  3  10  9 
The  purpose  listed  is  the  one  that  is  in  the  source  code  of  the 
l nc 1 ude  file 

A  purpose  of  '••••  PURPOSE  NOT  FOUND  BY  STRIPPER  . 

indicates  that  a  purpose  statement  was  not  written  into  the 
include  file  itself  The  most  common  reason  for  this  is  that 
the  include  file  comes  from  system  libraries  that  were  not 
developed  by  the  project,  such  as  C  libraries  that  are 
provided  with  the  C  compiler 

See  section  3  10  6  for  a  set  of  lists  which  show  all 
the  modules  which  call  in  each  of  these  include  files 


File  Name 


AFPDEF 
Cl CODE 
CURSOR  1 
DBM AM E 
DEFCOM 
DEFIME 
FPCODE 
FPD 

FPEMSG 

FPPARM 

LDAI 

NTM 

ORACLE 
OROODE 
PS WORD I 
SRVRET 
STD  I O 
STDTY  P 
UP DCOM 
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UI  SERVICES  Include  File  List 

Purpose 


Application  DEFimtion  data  declarations 

Command  Interpreter  CODEs 

CURSOR  description 

Database  field  NAMES 

DEFCOM  data  delcarations 

DEFINE  form  data  declarations 

FORM  PROCESSOR  RETURN  CODES 

FORM  PROCESSOR  DATA 

FORM  PROCESSOR  ERROR  MESSAGES 

FORM  PROCESSOR  PARAMETERS 

oracle  Logon  Data  Area  description 

NTM  INTERFACE  INCLUDE  FILE 

data  delcarations  for  programs  that  access  ORACLE 
ORacle  CODEs 

PaaSWORD  form  data  structure 

AS  THE  RETURN  GIVEN  A  TABLE -FULL  ERROR 

*•••  PURPOSE  NOT  FOUND  BY  STRIPPER  •••• 

STANDARD  TYPE  DEFINITIONS 

UP Date  COMmand  form  data  declarations 


''  1  b 
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3  105  Where  Include  File  Used  List 

The  following  lists,  each  include  file  fros  3  10  4  and 
all  the  modules  documented  in  this  specification  which  include 
thee  The  purpose  of  each  module  is  listed  as  well 
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UI  SERVICES  Where  include  file  used  List 


Ini  1  udr 

Mixlu  1 1 

Hod  u  1  e 

File 

Nm 

Purpose 

APPIiEF 

DBGAPD 

Get  APp 1 i cat l on ( Descr l pt l on 

DBIAPD 

Insert  Application  Description 

DBUAPl 

Update  Application  Description 

PROCAP 

PROCess  Application 

PROCDF 

PROCess  DeFine  fora 

PROCUC 

PROCess  Update  Coaaand  fora 

c  I  code 

DBGAPP 

PROCAP 

PROCDC 

Get  APP 1 i cat i ons 

PROCess  Application 
PROCess  Define  Command 

fora 

PROCDF 

PROCPW 

PROCUC 

PROCess 

PROCESS 

PROCess 

DeFine  fora 
PSWORD  FORM 
Update  Command 

fora 

CURSOR  I 

DBCUPR 

CHECK 

USER  I D  PASSWORD  ROLE  COMBINATION 

DBDAPF 

lx.'  1  e  t  c 

APP 1 l cat i on 

DBDAPR 

De  1  e  t  e 

APpRo 1 

DBGAPD 

Get  Application  Description 

DBGAPP 

Get  APP 1 l c  at i ons 

DBI APD 

Insert 

Application  Description 

DBOPEN 

OPEN  DATA  BASE 

DBUAPD 

U  pd  a  t  e 

Application  Description 

DBUPW 

UPDATE 

PASSWORD 

PROCAP 

PROCes 

i.  A  Pp  1  i  <  a  t  l  on 

P  ROC  DC 

PROC<  s 

Lx  f  i  ne  Command  f  orm 

PROCDF 

PROCes 

s  Define  form 

PROCPW 

PROCES 

S  PSWORD  FORM 

PROCUC 

PROCes 

s  Update  Command  form 
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UI  SERVICES  Where- include-fi le-used  List 

Include  Module  Module 

File  Name  Purpose 


DBNAME 

DBOPEN  OPEN  DATA  BASE 

PROCDF  PROCess  DeFine  form 

PROCPW  PROCESS  PSWORD  FORM 


DEFCOM 

P ROC DC  PROCess  Define  Command  form 


DEFINE 

PROCDF  PROCess  DeFine  form 


FPCODE 

DBCLSE  CLOSE  DATA  BASE 

DBCOM  COMMIT  DATA  BASE 

DBCUPR  CHECK  USERID- PASSWORD-ROLE  COMBINATION 

DBDAPP  Delete  Application 

DBDAPR  Delete  APpRol 

DBGAPD  Get  Application  Description 

DBGAPP  Get  Applications 

DBIAPD  Insert  Application  Description 

DBOPEN  OPEN  DATA  BASE 

DBROLL  ROLL  BACK  DATA  BASE 

DBUAPD  Update  Application  Description 

DBUPW  UPDATE  PASSWORD 

MM  MAIN  MAIN  MODULE  FOR  MESSAGE  MANAGEMENT 
MM'NEVFIL  SAVE  MESSAGES  IN  A  NEW  FILE 
MM  SAVEIT  SAVE  MESAGE  FILE  CHANGES 
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UI  SERVICES  Where-include-f i le-used  List 


Include 

Module 

Module 

Fi  le 

Name 

Purpose 

PROCAP 

PROCess 

APpl ication 

PROCDC 

PROCess 

Define 

Command 

form 

PROCDF 

PROCess 

DeFine 

form 

PROCPW 

PROCESS 

P SWORD 

FORM 

PROCUC 

PROCess 

Update 

Command 

form 

FPD 


INCGEN/MA  MAIN 
MM/MAIN  MAIN 
MM/NEWFIL  SAVE 
MM/SAVEIT  SAVE 


MODULE  FOR  INCLUDE  FILE  GENERATOR 
MODULE  FOR  MESSAGE  MANAGEMENT 
MESSAGES  IN  A  NEW  FILE 
MESAGE  FILE  CHANGES 


FPEMSG 


INCGEN/MA  MAIN 
MM/MAIN  MAIN 
MM/NEWFIL  SAVE 
MM/SAVEIT  SAVE 


MODULE  FOR  INCLUDE  FILE  GENERATOR 
MODULE  FOR  MESSAGE  MANAGEMENT 
MESSAGES  IN  A  NEW  FILE 
MESAGE  FILE  CHANGES 


*:• 


„■% 


r  \ 


FPPARM 

MM/MAIN  MAIN  MODULE  FOR  MESSAGE  MANAGEMENT 
MM/NEWFIL  SAVE  MESSAGES  IN  A  NEW  FILE 
MM/SAVEIT  SAVE  MESAGE  FILE  CHANGES 


PROCDC 

PROCess 

Define 

Command 

f  orm 

PROCDF 

PROCess 

DeFine 

form 

PROCPW 

PROCESS 

PSWORD 

FORM 

PROCUC 

PROCess 

Update 

Command 

f  orm 

LDAI 


-A' 

y-7- 


ln1i«VlAiAA  ■»  m 


■V.li  ■ 


3-22 
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01  SERVICES  Where-include-f i le-used  List 

Include  Module  Module 

File  Name  Purpose 


DBCLSE  CLOSE  DATA  BASE 

DBCOM  COMMIT  DATA  BASE 

DBOPEN  OPEN  DATA  BASE 

DBROLL  ROLL  BACK  DATA  BASE 

PROCAP  PROCess  Application 

PROCDC  PROCess  Define  Command  form 

PROCDF  PROCess  DeFine  form 

PROCPW  PROCESS  PSWORD  FORM 

PROCUC  PROCess  Update  Command  form 


NTM 

MM/MAIN  MAIN  MODULE  FOR  MESSAGE  MANAGEMENT 
MM/NEWFIL  SAVE  MESSAGES  IN  A  NEW  FILE 
MM /SAVE IT  SAVE  MESAGE  FILE  CHANGES 


ORACLE 

DBCUPR  CHECK  USERID-PASSWORD-ROLE  COMBINATION 

DBDAPP  Delete  Application 

DBDAPR  Delete  APpRol 

DBGAPD  Get  Application  Description 

DBGAPP  Get  Applications 

DBIAPD  Insert  Application  Description 

DBOPEN  OPEN  DATA  BASE 

DBUAPD  Update  Application  Description 

DBUPW  UPDATE  PASSWORD 


ORCODE 

DBCLSE  CLOSE  DATA  BASE 

DBCOM  COMMIT  DATA  BASE 

DBCUPR  CHECK  USERID-PASSWORD-ROLE  COMBINATION 

DBDAPP  Delete  Application 
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UI  SERVICES  Where-include-f i le-used  List 

Include  Module  Module 

File  Name  Purpose 


DBDAPR  Delete  APpRo 1 

DBGAPD  Get  Application  Description 

DBGAPP  Get  Applications 

DBIAPD  Insert  Application  Description 

DBOPEN  OPEN  DATA  BASE 

DBROLL  ROLL  BACK  DATA  BASE 

DBUAPD  Update  Application  Description 

DBUPW  UPDATE  PASSWORD 


PROCAP 

P  ROC  DC 
PROCDF 
PROCPW 

PROCess 

PROCess 

PROCess 

PROCESS 

APpl ication 

Define  Command  form 
DeFine  form 

PSWORD  FORM 

PS WORD I 

PROCPW 

PROCESS 

PSWORD 

FORM 

SRVRET 

PROCDF 

PROCPW 

PROCess 

PROCESS 

DeFine 

PSWORD 

f  orm 

FORM 

STDIO 

INCGEN/MA  MAIN  MODULE  FOR  INCLUDE  FILE  GENERATOR 
MM /MAIN  MAIN  MODULE  FOR  MESSAGE  MANAGEMENT 

MM/NEWFIL  SAVE  MESSAGES  IN  A  NEW  FILE 
MM/SAVEIT  SAVE  MESAGE  FILE  CHANGES 


STDTYP 

INCGEN/MA  MAIN  MODULE  FOR  INCLUDE  FILE  GENERATOR 
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I 
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UI  SERVICES  Where-include-f i le-used  List 

Include  Module  Module 

File  Name  Purpose 


MM/MAIN  MAIN  MODULE  FOR  MESSAGE  MANAGEMENT 
MM/NEWFIL  SAVE  MESSAGES  IN  A  NEW  FILE 
MM/SAVEIT  SAVE  MESAGE  FILE  CHANGES 


UPDCOM 


PROCUC 


PROCess  Update  Command  form 
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UI  SERVICES  Where-external -rout ine-used  List 


System 

Module 


ADDFRM 


CLSFRM 


FCLOSE 


FEOF 


FOPEN 


FPRINTF 


Module  Module 

Name  Purpose 


MM/MAIN  MAIN  MODULE  FOR  MESSAGE  MANAGEMENT 
PROCDC  PROCess  Define  Command  form 

PROCDF  PROCess  DeFine  form 

PROCPW  PROCESS  PS WORD  FORM 

PROCUC  PROCess  Update  Command  form 


PROCDF  PROCess  DeFine  form 
PROCPW  PROCESS  PSWORD  FORM 


INCGEN/MAIMAIN  MODULE  FOR  INCLUDE  FILE  GENERATOR 
MM/NEWFILESAVE  MESSAGES  IN  A  NEW  FILE 
MM/SAVEIT  SAVE  MESAGE  FILE  CHANGES 


INCGEN/MAIMAIN  MODULE  FOR  INCLUDE  FILE  GENERATOR 


INCGEN/MAIMAIN  MODULE  FOR  INCLUDE  FILE  GENERATOR 
MM/NEWFILESAVE  MESSAGES  IN  A  NEW  FILE 
MM/SAVEIT  SAVE  MESAGE  FILE  CHANGES 


INCGEN/MAIMAIN  MODULE  FOR  INCLUDE  FILE  GENERATOR 


FREAD 
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S' 
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UI  SERVICES  Where-external -routine-used  List 

System  Module  Module 

Module  Name  Purpose 


INCGEN/MAIMAIN  MODULE  FOR  INCLUDE  FILE  GENERATOR 
MM/NEWFILESAVE  MESSAGES  IN  A  NEW  FILE 


FWRITE 

MM/SAVEIT  SAVE  MESAGE  FILE  CHANGES 


GDATA 

MM /MAIN  MAIN  MODULE  FOR  MESSAGE  MANAGEMENT 

PROCDC  PROCess  Define  Command  form 

PROCDF  PROCess  DeFine  form 

PROCPW  PROCESS  P SWORD  FORM 

PROCUC  PROCess  Update  Command  form 


GETCHAR 

INCGEN/MAIMAIN  MODULE  FOR  INCLUDE  FILE  GENERATOR 


GETS 

INCGEN/MAIMAIN  MODULE  FOR  INCLUDE  FILE  GENERATOR 


GPAGE 

PROCDF  PROCess  DeFine  form 


INITAL 

MM/MAIN  MAIN  MODULE  FOR  MESSAGE  MANAGEMENT 
PROCDF  PROCess  DeFine  form 

PROCPW  PROCESS  PSWORD  FORM 
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01  SERVICES  Where-external -rout ine-used  List 

System  Module  Module 

Module  Name  Purpose 


INITFP 

MM/MAIN  MAIN  MODULE  FOR  MESSAGE  MANAGEMENT 
PROCDF  PROCess  DeFine  form 

PROCPW  PROCESS  PSWORD  FORM 


MEMCMP 

MM /MAIN  MAIN  MODULE  FOR  MESSAGE  MANAGEMENT 

MM/SAVEIT  SAVE  MESAGE  FILE  CHANGES 


MEMCPY 

MM /MAIN  MAIN  MODULE  FOR  MESSAGE  MANAGEMENT 

MM/NEWFILESAVE  MESSAGES  IN  A  NEW  FILE 


MEMSET 

MM/MAIN  MAIN  MODULE  FOR  MESSAGE  MANAGEMENT 
MM/NEWFILESAVE  MESSAGES  IN  A  NEW  FILE 


OBIND 

DBCUPR  CHECK  USERID-PASSWORD-ROLE  COMBINATION 

DBDAPP  Delete  Application 

DBDAPR  Delete  APpRol 

DBGAPD  Get  Application  Description 

DBGAPP  Get  Applications 

DBIAPD  Insert  Application  Description 

DBUAPD  Update  Application  Description 

DBUPW  UPDATE  PASSWORD 


PS  620144100 
1  November  1985 


UI  SERVICES  Where-externa 1 -rout ine-used  List 


System 

Module 

Modu  1  e 

Name 

Modu  1  e 

Purpose 

OCOM 

DBCOM 

COMMIT  DATA  BASE 

ODFINN 

DBCUPR 

CHECK  USERID-PASSWORD-ROLE  COMBINATION 

DBGAPD 

Get  Application  Description 

DBGAPP 

Get  Applications 

OEXEC 

DBCUPR 

CHECK  USER ID- PASSWORD-ROLE  COMBINATION 

DBDAPP 

Delete  Application 

DBDAPR 

Delete  APpRol 

DBGAPD 

Get  Application  Description 

DBGAPP 

Get  Applications 

DBIAPD 

Insert  Application  Description 

DBUAPD 

Update  Application  Description 

DBUPW 

UPDATE  PASSWORD 

OFETCH 

DBCUPR 

CHECK  USERID-PASSWORD-ROLE  COMBINATION 

DBGAPD 

Get  Application  Description 

DBGAPP 

Get  Applications 

01  SCR 

MM  MAIN 

MAIN  MODULE  FOR  MESSAGE  MANAGEMENT 

PROCDF 

PROCess  DeFine  form 

PROCPV 

PROCESS  PS WORD  FORM 

OLOGOF 

DBCLSE 

CLOSE  DATA  BASE 

& 


Ml 


»'»l 
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UI  SERVICES  Where- external -routine-used  List 


System 

Module 


OLON 


OOPEN 


OPNFRM 


OROL 


0SQL3 


PDATA 


Modu  1  e 
Name 


Modu 1 e 
Purpose 


DBOPEN 


OPEN  DATA  BASE 


DBOPEN 


MM/MAIN 

PROCDF 

PROCPW 


OPEN  DATA  BASE 


MAIN  MODULE  FOR  MESSAGE  MANAGEMENT 
PROCess  DeFine  form 
PROCESS  PSWORD  FORM 


DBROLL  ROLL  BACK  DATA  BASE 


DBCUPR  CHECK  USERID-PASSWORD-ROLE  COMBINATION 

DBDAPP  Delete  Application 

DBDAPR  Delete  APpRo 1 

DBGAPD  Get  Application  Description 

DBGAPP  Get  Applications 

DBIAPD  Insert  Application  Description 

DBUAPD  Update  Application  Description 

DBUPW  UPDATE  PASSWORD 


MM /MAIN  MAIN  MODULE  FOR  MESSAGE  MANAGEMENT 

MM/NEWFILESAVE  MESSAGES  IN  A  NEW  FILE 
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U I  SERVICES  Where-external -rout ine-used  List 


System 

Module 

Modu 1 e 

Modu 1 e 

Name 

Purpose 

P  ROC  DC 
PROCDF 

PROCess  Define  Command 
PROCess  DeFine  form 

f  orm 

PROCUC 

PROCess  Update  Command 

f  orm 

PMSGLS 

MM/MAIN 

MAIN  MODULE  FOR  MESSAGE 

MANAGEMENT 

P ROC DC 
PROCDF 
PROCPW 

PROCess  Define  Command 
PROCess  DeFine  form 
PROCESS  PSWORD  FORM 

form 

PROCUC 

PROCess  Update  Command 

f  orm 

PRINTF 

I NCGEN / MA I M A I N  MODULE  FOR  INCLUDE 

FILE  GENERATOR 

RMVPAG 

PROCDF 

PROCPW 

PROCess  DeFine  form 
PROCESS  PSWORD  FORM 

SPRINTF 

MM/NEWFILESAVE  MESSAGES  IN  A  NEW  FILE 


TERMFP 


MM/MAIN  MAIN  MODULE  FOR  MESSAGE  MANAGEMENT 
PROCDF  PROCess  DeFine  form 

PROCPW  PROCESS  PSWORD  FORM 


TRMNAT 

MM/MAIN 


MAIN  MODULE  FOR  MESSAGE  MANAGEMENT 
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UI  SERVICES  Where-external -rout ine-used  List 


System 

Module 

Module 

Module 

Name 

Purpose 

PROCDF 

PROCess 

DeFine  form 

PROCPW 

PROCESS 

PSVORD  FORM 
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3  10  7  Main  Program  Parts  List 

The  following  lists  each  Main  Program  listed  in  3.10.1 
and  all  the  modules  which  are  called  either  by  that  module 
itself  or  by  any  of  the  documented  modules  which  it  calls  I 
is  possible  for  a  non-main  module  to  be  listed  more  that  once 
if  it  is  called  by  multiple  modules.  The  called  modules,  in 
this  case  known  as  program  parts,  are  marked  as  to  whether 
they  are  documented  here  If  so.  the  phrase  "well-defined 
module"  appears  by  the  module  name,  if  not  it  i s  an  "external 
routine  The  Purpose  of  the  Main  Program  module  is  listed 
as  we  1  i 
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UI  SERVICES  Main  Program  Parts  List 

Main  Pgm  Module  Module 

Name  Name  Type 


> CHECK  USERID- PASSWORD-ROLE 
COMBINATION 
External  routine 
External  routine 
External  routine 
External  routine 
External  routine 


DBCUPR  Purpose-- 

OBIND 
ODFINN 
OEXEC 
OF ETCH 
OSQL3 
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UI  SERVICES  Main  Program  Parts  List 

Main  Pgm  Module  Module 

Name  Name  Type 


INCGEN/MAIN  Purpose-- 

FCLOSE 

FEOF 

FOPEN 

FPRINTF 

FREAD 

GETCHAR 

GETS 

PRINTF 


>  MAIN  MODULE  FOR  INCLUDE  FILE 
GENERATOR 
External  routine 
External  routine 
External  routine 
External  routine 
External  routine 
External  routine 
External  routine 
External  routine 
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UI  SERVICES  Main  Program  Parts  List 


Main  Pgm 

Module 

Module 

Name 

Name 

Type 

MM/MAIN 

Purpose- 

- >  MAIN  MODULE  FOR  MESSAGE 
MANAGEMENT 

ADDFRM 

External 

routine 

FCLOSE 

External 

routine 

FOPEN 

External 

routine 

FREAD 

External 

routine 

FWRITE 

External 

routine 

GDATA 

External 

routine 

INITAL 

External 

routine 

INITFP 

External 

routine 

MEMCMP 

External 

routine 

MEMCPY 

External 

routine 

MEMSET 

External 

routine 

MM/NEWFILE 

Well-defined  module 

MM/ SA VEIT 

Well-defined  module 

01  SCR 

External 

routine 

OPNFRM 

External 

routine 

PDATA 

External 

routine 

PMSGLS 

External 

routine 

SPRINTF 

External 

routine 

TERMFP 

External 

routine 

TRMNAT 

External 

routine 
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UI  SERVICES  Main  Program  Parts  List 


Main  Pgm 

Module 

Module 

Name 

Name 

Type 

PROCAP 

Purpose-- >  PROCess 

Application 

DBCOM 

Well-defined  module 

DBGAPD 

Well-defined  module 

OBIND 

External 

routine 

OCOM 

External 

routine 

ODFINN 

External 

routine 

OEXEC 

External 

routine 

OFETCH 

External 

routine 

OSOL3 

External 

routine 
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UI  SERVICES  Main  Program  Parts  List 


Main  Pgm 
Name 


Module 

Name 


Module 

Type 


PROCDF 


l 

I 

t 


Purpose-- > PROCess  DeFine  form 


ADDFRM 

External 

routine 

CLSFRM 

External 

routine 

DBCLSE 

Well-defined  module 

DBCOM 

Well-defined  module 

DBDAPP 

Well-defined  module 

DBDAPR 

Well-defined  module 

DBG A PD 

Well -def i ned  modu 1 e 

DBIAPD 

Well-defined  module 

DBOPEN 

Well-defined  module 

DBROLL 

Well-defined  module 

DBUAPD 

Well -def 

ined  module 

GDATA 

External 

routine 

GPAGE 

External 

routine 

INITAL 

External 

routine 

INITFP 

External 

routine 

OBIND 

External 

routine 

OCOM 

External 

routine 

ODFINN 

External 

routine 

OEXEC 

External 

rout  me 

OFETCH 

External 

rout ine 

01  SCR 

External 

rout i ne 

OLOGOF 

External 

rout  i  ne 

OLON 

External 

rout  ine 

OOPEN 

External 

rout  i  ne 

OPNFRM 

External 

rout  ine 

OROL 

External 

routine 

GSQL3 

Externa  1 

routine 

PDATA 

Externa  1 

routine 

PMSGLS 

Externa] 

routine 

PROCDC 

Wei  1 -def 

ined  module 

PROCUC 

Well-defined  module 

RMVPAG 

Externa  1 

rout  ine 

TERMFP 

External 

rout  i  ne 

TRMNAT 

External 

rout i ne 

:<  -  iO 


.V 
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UI  SERVICES  Main  Program  Parts  List 


Main  Pgm 

Module 

Module 

Name 

Name 

Type 

PROCPW 

Purpose-- > PROCESS  PSWORD  FORM 

ADDFRM 

External 

routine 

CLSFRM 

External 

routine 

DBCLSE 

Well-defined  module 

DBCOM 

Well-defined  module 

DBOPEN 

Well-defined  module 

DBUPW 

Well -def i 

ned  module 

GDATA 

External 

routine 

INITAL 

External 

routine 

INITFP 

External 

routine 

OBIND 

External 

routine 

OCOM 

External 

routine 

OEXEC 

External 

routine 

OISCR 

External 

routine 

OLOGOF 

External 

routine 

OLON 

External 

routine 

OOPEN 

External 

routine 

OPNFRM 

External 

routine 

0SQL3 

External 

routine 

PMSGLS 

External 

routine 

RMVPAG 

External 

routine 

TERMFP 

External 

routine 

TRMNAT 

External 

routine 

v*  t.w  '  V*  T?  *7' '  v 
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PS  620144100 
1  November  1985 


3.10.8  Module  Documentation 

The  following  documentation  describes  information 
which  is  specific  to  each  individual  module  being  documented 
in  this  specification  as  listed  in  section  3.10.2.  It 
provides  a  compact  way  of  getting  information  that  would  be 
otherwise  buried  within  each  module's  source  code. 

The  specific  items  in  this  module  documentation  have  the 
f  o  1  lowing  mean i ng s : 

NAME:  Name  of  program  Module. 

PURPOSE:  Purpose  of  Module  as  detailed  in  the 

source  code . 

LANGUAGE:  Programming  language  source  code  is 

written  in. 

The  choices  are: 

VAX- 11  FORTRAN 


C 


( I/S-l  Workbench  C) 
VAX- 11  COBOL 


MODULE  TYPE: 


Whether  a  Program,  Subroutine,  or 
Funct l on . 


SOURCE  FILE: 

SOURCE  FILE  TYPE 

HOST  . 


SUBSYSTEM 


Name  of  Source  File  from  file 
spec i f i cat i on . 

Source  File  Extension  from  file 
spec l f l cat i on . 

whether  this  is  a  hos t -dependent 
routine  (VAX  or  IBM)  or  blank  if 
ho:,  t.  -  i  ndependent 

ITSS  sub  system  this  file  resides  in. 


SUBDIRECTORY : 


Sub  directory  of  that  subsystem  in 
wh  : '  h  this-  file  res  ides 


DO(  1 U  M  L  N  V  A  TION  GKO  U I  - 


Nome  t  d  ><  umentat  l  or  group  of  which 
t.hir  ..ouitc  file  is  a  member 

f  ric:  ^  i  iption  of  the  module  as  otained 


d  4  2 


DESCRIP', TON 
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ARGUMENTS : 


INCLUDE  FILES: 


ROUTINES  CALLED: 


CALLED  DIRECTLY  BY: 


from  the  source  code. 

The  arguments  with  which  this  routine 
is  called  if  it  is  a  Subroutine  or  a 
Funct i on . 

A  list  of  all  the  files  that  are 
included  into  this  module  as  well  as 
their  purposes. 

Subroutines  or  Functions,  either 
documented  or  external,  called  by 
this  module,  if  any. 

The  documented  routines  which  call 
this  module,  if  any. 


USED  IN  MAIN  PROGRAM(S):  The  documented  Main  Programs  which 

contain  this  module  in  their  parts 
list  according  to  the  list  in  section 
3.10.7. 


The  Module  Documentation  is  arranged  alphabetically  according 
to  Module  Name. 
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L'i  SERVICES  Moau 

ic  Doc  umentiit  i  on 

NAML 

DBCLSE 

PURPOSE 

CLOSE  DATA  BASE 

LANGUAur 

V'AE  1  1  COBOL 

MODULE  TYPE 

SUBROUTINE 

SOURCE  FILE 

DBCLSE 

SOURCE  FILE  TYPE 

COB 

HOST 

SUBSYSTEM 

UI 

SUBDIRECTORY 

UIS 

DOCUMENTATION  GROUP 

UISERV 

DESCRIPTION 

THIS  MODULE  CLOSES 

THE  ORACLE  DATA 

BASE 

ARGUMENTS 

LDA  --  RECRD 

RCOLL  =  DS  PLY  [ X  (  5 

'  J 

INCLUDE  FILES 

Y  R  j'.  r  OR-..: 

•  COI  r. : 

F:  Li I.  E  -  FuRfc 

f  Rut  IELSOR  RETURN 

CODES 

-LA  • .  r  a  * 

*  i. .  ^  . : i  L (t  t  ii  A I  t,  i 

i  due  M 

.  p  t  j  or. 
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U I  SERVICES  Module  Documentation 


NAME 
PURPOSE 
LANGUAGE . 

MODULE  TYPE 
SOURCE  FILE: 

SOURCE  FILE  TYPE- 
HOST  . 

SUBSYSTEM 
SUBDIRECTORY . 
DOCUMENTATION  GROUP: 


DBCOM 

COMMIT  DATA  BASE 

VAX- 11  COBOL 

SUBROUTINE 

DBCOM 

.COB 

UI 

UIS 

UISERV 


DESCRIPTION : 


THIS  MODULE  COMMITS  UPDATES  TO  THE  ORACLE  DATA  BASE 


ARGUMENTS 


LDA  =  RECRD 

RCOLE  DSPLY  [  X  ;  5  i  ; 


INCLUDE  FILES 

c,p  •;»: -  or  i  .  i  <•  code. 

r  :  .,wl  E  -  FORM  PROCESSOR  RETURN  CODES 

LI  A I  -  r.t:  I  •  L'.>£  or.  Data  Area  description 
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USED  IN  MAIN  PROGRAM ( S ) : 


PROCAP  -  PROCess  Application 
PROCDF  -  PROCess  DeFine  form 
PROCPW  -  PROCESS  PS WORD  FORM 
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I 


M 


AM 


U I  SERVICES  Module  Documentation 


DBCUPR 

CHECK  USERID-PASSWORD-ROLE  COMBINATION 

VAX- 11  COBOL 

SUBROUTINE 

DBCUPR 

.COB 


NAME :  DBCUPR 

PURPOSE  CHECK  l 

LANGUAGE:  VAX- 11 

MODULE  TYPE :  SUBROU1 

SOURCE  FILE:  DBCUPR 

SOURCE  FILE  TYPE’  .COB 

HOST  : 

SUBSYSTEM:  UI 

SUBDIRECTORY:  UIS 

DOCUMENTATION  GROUP:  UISERV 

DESCRIPTION : 


THIS  MODULE  CHECKS  A  USERID,  PASSWORD.  AND 
ROLE  TO  SEE  IF  THEY  FORM  A  VALID  COMBINATION. 


ARGUMENTS : 


CURSOR  =  RECRD 
USERID  =  DSPLY  [X( 10 ) ] 
PS WORD  =  DSPLY  [ X(  10  )  j 
ROLE  =  DSPLY  [  X  (  10  )  ] 
RCODE  =  DSPLY  [X(5>] 


INCLUDE  FILES 


OkACLr. 


OPCODE 
F PCODF 
CURS'  )R  : 


data  delcarations  for  programs  that  access 
ORACLE 
ORa-i..  CODE: 

FORM  PROCESSOR  RETURN  CODES 
CURSOR'  description 


ku'";  1  NE:  CALLED 


o  p  :  N" 

>E  «  F. 

. ;  f  :  n  ?. 

OF  L'l ;  } 
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UI  SERVICES  Module  Documentation 


NAME : 

PURPOSE : 

LANGUAGE : 

MODULE  TYPE: 

SOURCE  FILE: 

SOURCE  FILE  TYPE: 
HOST: 

SUBSYSTEM : 
SUBDIRECTORY: 
DOCUMENTATION  GROUP: 

DESCRIPTION : 


DBDAPP 

Delete  Application 

VAX- 11  COBOL 

SUBROUTINE 

DBDAPP 

.COB 

UI 

UIS 

UISERV 


THIS  MODULE  DELETES  AN  APPLICATION. 


ARGUMENTS : 


CURSOR  =  RECRD 

APPLICATION-ID  =  DSPLY  [X(10)] 
RCODE  =  DSPLY  [X(5)] 


INCLUDE  FILES: 


ORACLE 

ORCODE 

FPCODE 

CURSORI 


data  delcarations  for  programs  that  access 
ORACLE 
ORacle  CODES 

FORM  PROCESSOR  RETURN  CODES 
CURSOR  description 


ROUTINES  CALLED: 


0SQL3 

OBIND 

OEXEC 


CALLED  DIRECTLY  BY 


PROCUC  -  PROCess  Update  Command  form 


PS  620144100 
1  November  1985 


USED  IN  MAIN  PROGRAM! S  )  : 


PROCDF 


PROCess  DeFine  form 


1 


UI  SERVICES  Module  Documentation 


NAME: 

PURPOSE : 

LANGUAGE : 

MODULE  TYPE: 

SOURCE  FILE: 

SOURCE  FILE  TYPE: 
HOST: 

SUBSYSTEM: 
SUBDIRECTORY : 
DOCUMENTATION  GROUP: 


DBDAPR 

Delete  APpRol 

VAX- 11  COBOL 

SUBROUTINE 

DBDAPR 

.COB 

UI 

UIS 

UISERV 


DESCRIPTION : 


THIS  MODULE  DELETES  ENTRIES  IN  THE  ROLAPP 
TABLE  FOR  A  SPECIFIC  APPLICATION.  IT  IS 
USED  WHEN  AN  APPLICATION  IS  DELETED. 


ARGUMENTS : 

CURSOR  =  RECRD 

APPLICATION-ID  =  DSPLY  [ X( 10)] 


fry. 

RCODE  = 

DSPLY  [ X( 5 ) ] 

*  Vv. 

INCLUDE  FILES: 

t-v-; 

\yS/ 

ORACLE 

-  data  delcarations  for 

E*£>. 

ORACLE 

ORCODE 

-  ORacle  CODES 

FT-* 

FPCODE 

-  FORM  PROCESSOR  RETURN 

[S;/; 

k*»V 

CURSORI 

-  CURSOR  description 

£v: 

ROUTINES 

CALLED: 

t  ’/  V 

OSQL3 

OBIND 

v  ■.  • 

\r-.' 

OEXEC 

i* 

CALLED  DIRECTLY  BY: 

•4 


$ 


> 
> 


i "  '  - 


Lu 
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that  access 


3-51 
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PROCUC  PROCess  Update  Command  form 

USED  IN  MAIN  PROGRAM ( S  )  : 


PROCDF  -  PROCess  DeFine  form 


PS  620144100 
1  November  1985 


UI  SERVICES  Module  Documentation 


NAME  : 

PURPOSE : 

LANGUAGE : 

MODULE  TYPE: 

SOURCE  FILE: 

SOURCE  FILE  TYPE: 
HOST: 

SUBSYSTEM : 
SUBDIRECTORY: 
DOCUMENTATION  GROUP: 


DBGAPD 

Get  Application  Description 
VAX- 11  COBOL 
SUBROUTINE 
DBGAPD 
.COB 

UI 

UIS 

UISERV 


DESCRIPTION : 


THIS  MODULE  GETS  THE  DESCRIPTION  OF  AN 
APPLICATION. 


ETCHED  (OK) 


ARGUMENTS : 


CURSOR  =  RECRD 

APPLICATION-ID  =  DSPLY  [X(10)] 
APPLICATION-DEFINITION  =  RECRD 
RCODE  =  DSPLY  [X(5)] 


INCLUDE  FILES: 


ORACLE 

ORCODE 

FPCODE 

CURSORI 

APPDEF 


data  delcarations  for  programs  that  access 
ORACLE 
ORacle  CODES 

FORM  PROCESSOR  RETURN  CODES 
CURSOR  description 

Application  DEFinition  data  declarations 


ROUTINES  CALLED: 


OSQL3 

OBIND 

OEXEC 

ODFINN 


PS  620144100 
1  November  1965 


OFETCK 


CALLED  DIRECTLY  BY: 


PROCAP  -  PROCess  Application 

PROCDF  -  PROCess  DeFine  form 


USED  IN  MAIN  PROGRAM ( S ) : 


PROCAP  -  PROCess  Application 

PROCDF  -  PROCess  DeFine  form 


PS  620144100 
1  November  1985 


UI  SERVICES  Module  Documentation 


NAME  : 

PURPOSE : 

LANGUAGE : 

MODULE  TYPE: 

SOURCE  FILE: 

SOURCE  FILE  TYPE: 
HOST: 

SUBSYSTEM : 
SUBDIRECTORY : 
DOCUMENTATION  GROUP: 

DESCRIPTION : 


DBGAPP 

Get  Applications 
VAX- 11  COBOL 
SUBROUTINE 
DBGAPP 
.COB 

UI 

UIS 

UISERV 


THIS  MODULE  GETS  THE  NAMES  OF  THE 
APPLICATIONS  THAT  ARE  VALID  FOR  A 
PARTICULAR  ROLE. 


ARGUMENTS : 


CURSOR  =  RECRD 
C^'TTINUATION-IND  =  DSPLY  [Xj 
•  .E  =  DSPLY  [X(10)] 

.  .'PLICATION  =  RECRD 
RCODE  =  DSPLY  [ X( 5 ) 3 


INCLUDE  FILES: 


Cl CODE 
ORACLE 

ORCODE 
FPCODE 
CURSOR  I 


Command  Interpreter  CODEs 

data  delcarations  for  programs  that  access 
ORACLE 
ORacle  CODEs 

FORM  PROCESSOR  RETURN  CODES 
CURSOR  description 


ROUTINES  CALLED: 


OSQL3 

OBIND 

OEXEC 

ODFINN 


PS  620144100 
1  November  198^ 


UI  SERVICES  Module  Documentation 


NAME 

PURPOSE 

LANGUAGE 

MODULE  TYPE 

SOURCE  FILE 

SOURCE  FILE  TYPE 

HOST 

SUBSYSTEM 
SUBDIRECTORY 
DOCUMENTATION  GROUP 


DBIAPD 

Insert  Application  Description 
VAX- 11  COBOL 
SUBROUTINE 
DBIAPD 
COB 

UI 

UIS 

UISERV 


DESCRIPTION 


THIS  MODULE  INSERTS  AN  APPLICATION 
DESCRIPTION 


ARGUMENTS 


CURSOR  -  RECRD 

APPLICATION-ID  «  DSPLY  t  XC 10)3 
APPLICATION-DEFINITION  =  RECRD 
RCODE  =  DSPLY  [ X( 5  )  ] 


INCLUDE  FILES 


ORACLE 

ORCODE 
FPCODE 
CURSOR I 
APPDEF 


data  delcarations  for  programs  that  access 
ORACLE 
ORacle  CODES 

FORM  PROCESSOR  RETURN  CODES 
CURSOR  description 

Application  DEFinition  data  declarations 


ROUTINES  CALLED 


OSQL3 

OBIND 

OEXEC 


CALLED  DIRECTLY  BY 


PS  620144100 
1  November  1985 


l' I  SERV  :  CES  Moduli  Uh  umcnt>ition 


NAME 

PURPOSE 
LANGUAGE 
MODULE  TYPE 
SOURCE  FILE 
SOURCE  FILE  TYPE 
HOST 

SUBSYSTEM 
SUBDIRECTORY 
DOCUMENTATION  GROUP 


DBOPEN 

OPEN  DATA  BASE 
VAX  1 1  COBOL 
SUBROUTINE 
DBOPEN 
COB 


UI 

UIS 

U : SERV 


DE  SCR  I PTION 


THIS  MODULE  OPENS  AN  ORACLE  DATA  BASE 


ARGUMENTS 

DATABASE  NAME  «  DSFLY  [X'15'l 
NAML  LENGTH  -  DS  PLY  I S9999 ] 
LDA  -  RECRI 
'"UP  SOF  *  RECRI 
RCODE  •  DSFLY  [X  5  } 


INDLUD l  files 


DRACLF 


opcode 
EF'Co:  e 

I  BN AM E 
LDA  : 

CURSOR : 


data  d<  If -ir.itiont  for  program:  that  acccr : 

ORACLE 
ORar  k  CODE: 

FORM  PROCESSOR  RETURN  CODES 
[MtaB.iL  c  field  NAME: 

era  i<  Lo£on  Data  Area  description 
CURSOR  dfLf ription 


routine:  callei 

Ul/ON 
LAI  PEN 


PS  620144100 
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UI  SERVICES  Module  Documentation 


NAME 

PURPOSE 

LANGUAGE 

MODULE  TYPE 

SOURCE  FILE 

SOURCE  FILE  TYPE 

HOST 

SUBSYSTEM 
SUBDIRECTORY 
DOCUMENTATION  GROUP 

DESCRIPTION 


DBROLL 

ROLL  BACK  DATA  BASE 
VAX- 11  COBOL 
SUBROUTINE 
DBROLL 
.  COB 

UI 

UIS 

UISERV 


THIS  MODULE  ROLLS  BACK  THE  CURRENT  ORACLE 
DATA  BASE  TRANSACTION 


ARGUMENTS 


LDA  =  RECRD 

RCODE  -  DS  PLY  [X(5)] 


INCLUDE  FILES 


ORCODE  -  ORacle  CODEr 

FPCODE  FORM  PROCESSOR  RETURN  CODES 

LDA  I  orctrlc  Logon  Data  Area  description 


ROUTINES  CALLED 
OROL 


CALLED  DIRECTLY  BY 

PROCUC  PROGcr :  Update  Command  form 

U  S  E I  IN  MAIN  P  ROGF.A  M'S' 


S  “t 


~w - l-fT"!*!"!'  wr*  f  V*  V 


31 

i 


r,* 
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UI  SERVICES  Module  Documentation 


NAME 

PURPOSE 
LANGUAGE 
MODULE  TYPE 
SOURCE  PILE 
SOURCE  FILE  TYPE 
HOST 

SUBSYSTEM 
SUBDIRECTORY 
DOCUMENTATION  GROUP 


DBUAPD 

Update  Application  Description 

VAX- 11  COBOL 

SUBROUTINE 

DBUAPD 

COB 

UI 

Ul  s 

UISERV 


DESCRIPTION 

THIS  MODULE  UPDATES  THE  DESCRIPTION  OF 
AN  APPLICATION 


PDATEI  ! OK 


ARGUMENTS 


CURSOR  -  RECRI 

APPLICATION  II  •  DSPLY  [XMC'] 
APPLICATION  DEP1NITION  -  RECRI 
RDOLP  *  DSPL’:  [  X  5  . 


IN  'DUDE  PILE: 


'  .RAGLE 

i/RCviLI 
V TGOI  f 
up-  SoR  I 
A  P  P  I  E  P 


d.it.i  d<  .  aration:  ft.:  piopiams  that  at  t  cs. 

ORACLE 
ORa  if  CODE: 

FORM  PROCESSOR  RETURN  CODES 
CURSOR  der  i  l  pt  i  on 

A  P  P  -  .  t  <»  f  i  or.  DEF  i  n  i  1 1  or.  data  doc ■  1  ara  t  l  on : 


R  "TINPL  DALLE! 

•  ■  v  *  - 
i  bin: 

'  XP. 


r>: 


F  ■ 
► 
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CALLED  DIRECTLY  BY: 

PROCUC  -  PROCess  Update  Command  form 

USED  IN  MAIN  PROGRAM ( S ) 

PROCDF  -  PROCess  DeFine  form 


D-64 


PS  620144100 
1  November  1985 


UI  SERVICES  Module  Documentation 


NAME 
PURPOSE 
LANGUAGE 
MODULE  TYPE 
SOURCE  FILE: 

SOURCE  FILE  TYPE • 

HOST 

SUBSYSTEM 
SUBDIRECTORY 
DOCUMENTATION  GROUP  UISERV 


DBUPW 

UPDATE  PASSWORD 
VAX- 11  COBOL 
SUBROUTINE 
DBUPW 
COB 

UI 

UIS 


DESCRIPTION 


THIS  MODULE  CHANGES  THE  PASSWORD  FOR  A  PARTICULAR  USER  ID. 

THE  OLD  PASSWORD  -  USER  ID  COMBINATION  MUST  BE  CORRECT  BEFORE 
A  CHANGE  IS  MADE. 


ARGUMENTS 


CURSOR  =  RECRD 
USERID  =  DSPLY  [ X ( 10)] 
OLDPSWORD  =  DSPLY  [X(10>] 
NEVPSWORE  =  DSPLY  [X(10)] 
RCODL  =  DSPLY  [Xf5'] 


INCLUDE  FILES 


ORACLE 


ORCOI'E 
FECODE 
CURSOR I 


data  delcarations  for  programs  that  access 
ORACLE 
ORacle  CODEs 

FORM  PROCESSOR  RETURN  CODES 
CURSOR  description 


ROUTINES  CA 


EL 


OSQL~ 
OB  INI 
OEX  Er 


PS  620144100 
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CALLED  DIRECTLY  BY: 

PROCPV  -  PROCESS  PSWORD  FORM 

USED  IN  MAIN  PROGRAM IS): 

PROCPW  -  PROCESS  PSWORD  FORM 


PS  620144100 
1  November  1985 


UI  SERVICES  Module  Documentation 


NAME  : 

PURPOSE : 

LANGUAGE : 

MODULE  TYPE : 

FUNCTION  TYPE: 

SOURCE  FILE: 

SOURCE  FILE  TYPE: 
HOST  : 

SUBSYSTEM : 
SUBDIRECTORY : 
DOCUMENTATION  GROUP: 


INCGEN/MAIN 

MAIN  MODULE  FOR  INCLUDE  FILE  GENERATOR 

C 

FUNCTION 
INT  (  ) 

INCGEN 

.C 

UI 

MM 

UISERV 


DESCRIPTION : 


SYNOPSIS 

VOID  MAIN( ) 

DESCRIPTION 

GENERATES  AN  INCLUDE  FILE  FROM  MESSAGE  FILE(S) 


INCLUDE  FILES: 


STDTYP 

STDIO 

FPD 

FPEMSG 


STANDARD  TYPE  DEFINITIONS 

***’  PURPOSE  NOT  FOUND  BY  STRIPPER  **** 

FORM  PROCESSOR  DATA 

FORM  PROCESSOR  ERROR  MESSAGES 


ROUTINES  CALLED: 


PRINTF 

GETS 

FOPEN 

FEOF 

FREAD 

FPP.INTF 

FCLOSE 

GETCHAR 


PS  620144100 
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UI  SERVICES  Module  Documentation 


NAME  : 

PURPOSE 
LANGUAGE : 

MODULE  TYPE : 
FUNCTION  TYPE: 
SOURCE  FILE: 

SOURCE  FILE  TYPE: 
HOST 

SUBSYSTEM : 
SUBDIRECTORY : 
DOCUMENTATION  GROUP 

DESCRIPTION : 


SYNOPSIS 
MAIN(  ) 

DESCRIPTION 

UTILITY  TO  MAINTAIN  MESSAGE  FILES  USED  BY  FORM  PROCESSOR 


INCLUDE  FILES: 

STDTYP 
STD  10 
FPPARM 
FPL 

F  PC. '.ODE 
FPEMSG 
NTM 


ROUTINES  CALLED 

: N T  TAD 
MEMOMP 
T  m  r : 


*’•  !  LI  SAVE  M ESS. AGES  IN  A  NEW  FILE 
LAV?  MESAGE  FILE  CHANGES 


-  STANDARD  TYPE  DEFINITIONS 

-  ’***  PURPOSE  NOT  FOUND  BY  STRIPPER 

-  FORM  PROCESSOR  PARAMETERS 

-  FORM  PROCESSOR  DATA 

FORM  PROCESSOR  RETURN  CODES 
FORM  PROCESSOR  ERROR  MESSAGES 
NTM  INTERFACE  INCLUDE  FILE 


MM/MAIN 

MAIN  MODULE  FOR  MESSAGE  MANAGEMENT 

C 

FUNCTION 

r  f  \  . . 

MM 

C 

UI 

MM 

UISERV 


S  08 
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GDATA 

MEMSET 

01  SCR 

ADDFRM 

TRMNAT 

INITFP 

OPNFRM 


PS  620144100 
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UI  SERVICES  Module  Documentation 


NAME 
PURPOSE : 

LANGUAGE : 

MODULE  TYPE : 

FUNCTION  TYPE: 

SOURCE  FILE: 

SOURCE  FILE  TYPE: 
HOST 

SUBSYSTEM : 
SUBDIRECTORY : 
DOCUMENTATION  GROUP : 


MM/NEWFILE 

SAVE  MESSAGES  IN  A  NEW  FILE 
C 

SUBROUTINE 
VOID  (  ) 

MM 

.C 

UI 

MM 

UISERV 


DESCRIPTION : 


ARGUMENTS 


FILEDESC  =  CHAR  U 

BASE  =  CHAR  [ ] 


INCLUDE  FILES: 


STDTYP 

STDIO 

FPPARM 

FPD 

FPCODE 

FPEMSG 

NTM 


STANDARD  TYPE  DEFINITIONS 

***•  PURPOSE  NOT  FOUND  BY  STRIPPER 

FORM  PROCESSOR  PARAMETERS 

FORM  PROCESSOR  DATA 

FORM  PROCESSOR  RETURN  CODES 

FORM  PROCESSOR  ERROR  MESSAGES 

NTM  INTERFACE  INCLUDE  FILE 


ROUTINES  CALLED: 


PDATA 

MEMCPY 

FCLOSE 

FREAI 

FOPEN 

SPRINTE 

MEMSET 


3 -VO 
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CALLED  DIRECTLY  BY: 

MM/MAIN  -  MAIN  MODULE  FOR  MESSAGE  MANAGEMENT 

USED  IN  MAIN  PROGRAM ( S ) : 

MM/MAIN  -  MAIN  MODULE  FOR  MESSAGE  MANAGEMENT 


PS  620144100 
1  November  1985 


UI  SERVICES  Module  Documentation 


NAME  : 

PURPOSE : 

LANGUAGE . 

MODULE  TYPE: 

FUNCTION  TYPE: 

SOURCE  FILE: 

SOURCE  FILE  TYPE: 
HOST  : 

SUBSYSTEM ; 
SUBDIRECTORY : 
DOCUMENTATION  GROUP: 


MM ' SAVE IT 

SAVE  MESAGE  FILE  CHANGES 
C 

FUNCTION 
BOOL  (  ) 

MM 

C 

UI 

MM 

UISERV 


DESCR  PTION: 


ARGUMENTS . 

FILEDESC  -  CHAR  f] 


INCLUDE  FILES: 


STDTYF 

STDIO 

FPPARM 

FPD 

FPCODE 

FPEMSG 

NTH 


STANDARD  TYPE  DEFINITIONS 

****  PURPOSE  NOT  FOUND  BY  STRIPPER  **’* 

FORM  PROCESSOR  PARAMETERS 

FORM  PROCESSOR  DATA 

FORM  PROCESSOR  RETURN  CODES 

FORM  PROCESSOR  ERROR  MESSAGES 

NTM  INTERFACE  INCLUDE  FILE 


ROUTINES  CALLED: 


FCLOSE 

FWRITE 

MEMCMP 

FGPEN 


CALLED  DIRECTLY  BY 


MM  MAIN  -  MAIN  MODULE  FOR  MESSAGE  MANAGEMENT 


PS  620144100 
1  November  1985 


USED  IN  MAIN  PROGRAM ( S  )  : 

MM /MAIN  -  MAIN  MODULE  FOR  MESSAGE  MANAGEMENT 


PS  620 1 44 1 00 
1  November  198b 


UI  SERVICES  Moduli  iJotumenlaUun 


NAME 

PURPOSE 
LANGUAGE 
MODULE  TYPE 
SOURCE  FILE 
SOURCE  FILE  TYPE 
HOST 

SUBSYSTEM 
SUBDIRECTORY 
DOCUMENTATION  GROUP 


PROCAF 

PROCess  Application 
VAX- 11  COBOL 
SUBROUTINE 
PROCAP 
COB 

UI 

UIS 

UISERV 


DESCRIPTION 


THIS  MODULE  PROCESSES  A  REQUEST  TO  RUN 
A  REMOTE  APPLICATION. 


ARGUMENTS 


LDA  -  RECRD 

CURSOR  =  RECRD 

FUNCTION  =  DSPLY  [X(10l] 

ACTION  CODE  -  DSPLY  ( X (  5  )  j 

MSG -HEADER  =  DSPLY  [Xv  800)] 

RCODE  -  DSPLY  [X(5)j 


INCLUDE  FILES 


C  •  I COLL 
GRCODE 
FPCODF 
APPLE,  r 
LDAI 

cursor: 


Command  Interpreter  CODEs 
OR  etc  1  e  CODEc 

FORM  PROCESSOR  RETURN  CODES 
Application  DEFimtion  data  declarations 
oracle  Lofon  Data  Area  description 
CURSOR  description 


ROUTINES  CALLEI 

Get  ARp.iCai.or.  Description 

commit’  data  ball 


DBGAK 

DBCOM 


PS  620144100 
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U1  SERVICES  Module  Documentation 


NAME 
PURPOSE : 

LANGUAGE : 

MODULE  TYPE  : 

SOURCE  FILE: 

SOURCE  FILE  TYPE: 
HOST  : 

SUBSYSTEM : 
SUBDIRECTORY : 
DOCUMENTATION  GROUP 


PROCDC 

PROCess  Define  Command  form 

VAX- 11  COBOL 

SUBROUTINE 

PROCDC 

.COB 

UI 

UIS 

UISERV 


DESCRIPTION : 

THIS  MODULE  PROCESSES  THE  DEFCOM  FORM  OF 
THE  UIMS  SYSTEM  SERVICES. 


ARGUMENTS : 

LDA  =  RECRD 
CURSOR  =  RECRD 
ACTION-CODE  =  DSPLY  tX(5)] 
APPLICATION-ID  =  DSPLY  [X(10)] 
RCODE  =  DSPLY  [X(5)] 


INCLUDE  FILES: 


Cl CODE 
DEFCOM 
FPPARM 
ORCODE 
FPCODE 
LDA  I 


Command  Interpreter  CODES 
DEFCOM  data  del  carat  ions 
FORM  PROCESSOR  PARAMETERS 
ORacle  CODES 

FORM  PROCESSOR  RETURN  CODES 
oracle  Logon  Data  Area  description 


CURSORI  -  CURSOR  description 


ROUTINES  CALLED: 


ADDFRM 

PDATA 

GDATA 

DBIAPD 


-  Insert  Application  Description 


3-75 
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DBCOM  -  COMMIT  DATA  BASE 

PMSGLS 

CALLED  DIRECTLY  BY: 

PROCDF  -  PROCess  DeFine  form 

USED  IN  MAIN  PROGRAM! S): 

PROCDF  -  PROCess  DeFine  form 


PS  620144100 
1  November  1985 


UI  SERVICES  Module  Documentation 


NAME 
PURPOSE : 

LANGUAGE 
MODULE  TYPE : 

SOURCE  FILE: 

SOURCE  FILE  TYPE 
HOST  : 

SUBSYSTEM 
SUBDIRECTORY : 
DOCUMENTATION  GROUP: 

DESCRIPTION 


PROCDF 

PROCess  DeFine  form 
VAX- 11  COBOL 
PROGRAM 
PROCDF 
COB 

UI 

UIS 

UISERV 


THIS  MODULE  PROCESSES  THE  DEFINE  FORM  OF 

THE  UI 

SERVICES . 

INCLUDE  FILES: 

APPDEF 

-  Application  DEFinition  data  declarations 

Cl  CODE 

-  Command 

Interpreter  CODEs 

DEFINE 

-  DEFINE 

form  data  declarations 

FPCODE 

-  FORM  PROCESSOR  RETURN  CODES 

FPPARM 

-  FORM  PROCESSOR  PARAMETERS 

DBNAME 

-  DataBase  field  NAMES 

ORCODE 

-  ORac 1 e 

CODES 

LDA I 

-  orac 1 c 

Logon  Data  Area  description 

CURSOR  I 

-  CURSOR 

description 

SRVRET 

-  AS  THE 

RETURN  GIVEN  A  TABLE-FULL  ERROR 

ROUTINES 

CALLED 

INI TAL 

INITFP 

TEP.MFP 

TRMNAT 

D30PEN 

-  OPEN  DA 

TA  BASE 

OPNFRM 

ADDFRM 

PLATA 

01  SCR 


n 

O 


-77 
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PMSGLS 

GDATA 

DBGAPD 

PROCDC 

PROCUC 

GPAGE 

RMVPAG 

CLSFRM 

DBCLSE 


Get  Application  Description 
PROCess  Define  Command  form 
PROCess  Update  Command  form 


CLOSE  DATA  BASE 


PS  620144100 
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UI  SERVICES  Module  Documentation 


NAME  : 

PURPOSE 
LANGUAGE : 

MODULE  TYPE : 

SOURCE  FILE: 

SOURCE  FILE  TYPE: 
HOST  : 

SUBSYSTEM : 
SUBDIRECTORY : 
DOCUMENTATION  GROUP: 

DESCRIPTION : 


PROCPW 

PROCESS  PSWORD  FORM 

VAX- 11  COBOL 

PROGRAM 

PROCPW 

.COB 

UI 

UIS 

UISERV 


THIS  MODULE  PROCESSES  THE  PSWORD  FORM  OF  THE 
UI  SERVICES. 


INCLUDE  FILES: 


Cl CODE 
FPPARM 
DBNAME 

ORCODE 

PS WORD I 

FPCODE 

lda: 

CURSORI 

SRVRET 


Command  Interpreter  CODEs 
FORM  PROCESSOR  PARAMETERS 
DataBase  field  NAMES 
ORacle  CODEs 

PaaSWORD  form  data  structure 
FORM  PROCESSOR  RETURN  CODES 
oracle  Logon  Data  Area  description 
CURSOR  description 

AS  THE  RETURN  GIVEN  A  TABLE-FULL  ERROR 


ROUTINES  CALLED 


INI TAL 
INITFP 
TERMFP 
TRMNAT 

DBG PEN  OPEN  LATA  BASE 
OPNERM 
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DBUPV 

DBCOM 

RMVPAG 

CLSFRM 

DBCLSE 


UPDATE  PASSWORD 
COMMIT  DATA  BASE 


CLOSE  DATA  BASE 
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UI  SERVICES  Module  Documentation 


NAME  . 

PURPOSE : 

LANGUAGE : 

MODULE  TYPE : 

SOURCE  FILE: 

SOURCE  FILE  TYPE: 
HOST  : 

SUBSYSTEM : 
SUBDIRECTORY : 
DOCUMENTATION  GROUP 

DESCRIPTION : 


PROCUC 

PROCess  Update  Command  form 

VAX- 11  COBOL 

SUBROUTINE 

PROCUC 

.COB 

UI 

UIS 

UISERV 


THIS  MODULE  PROCESSES  THE  UPDCOM  FORM  OF 
THE  DEFINE  APPLICATION  SERVICE. 


ARGUMENTS : 


LDA  =  RECRD 
CURSOR  =  RECRD 
ACTION-CODE  =  DSPLY  [X(5)] 
APPLICATION-ID  =  DSPLY  [ X(  10)3 
APPLICATION-DEFINITION  =  RECRD 
RCODE  =  DSPLY  [X(5)] 


INCLUDE  FILES 

Cl CODE 

UPDCOM 

FP! ARM 

FPCODE 

LDAI 

CURSOR  I 

APPDEF 


Command  Interpreter  CODEs 

UPDate  COMmand  form  data  declarations 

FORM  PROCESSOR  PARAMETERS 

FORM  PROCESSOR  RETURN  CODES 

oracle  Logon  Data  Area  description 

CURSOR  description 

Application  DEFinition  data  declarati 


ROUTINES  CALLED: 


ADDFRM 

PLATA 

GLATA 
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SOLUTION  USI 
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PMSGLS 

DBCOM  -  COMMIT  DATA  BASE 

DBDAPP  -  Delete  Application 

DBDAPR  -  Delete  APpRo 1 

DBROLL  -  ROLL  BACK  DATA  BASE 

DBUAPD  -  Update  Application  Description 


CALLED  DIRECTLY  BY: 

PROCDF  -  PROCess  DeFine  form 

USED  IN  MAIN  PROGRAM ( S ) : 

PROCDF  -  PROCess  DeFine  form 
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3.10.9  Include  File  Descriptions 

The  following  list  contains  a  purpose  and  description  of 
each  include  file  listed  in  3.10.4  as  specified  in  the  source 
code.  The  language  it  is  written  in  is  also  given. 
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UI  SERVICES  Include  File  Description 
FILE  NAME:  APPDEF 

PURPOSE:  Application  DEFinition  data  declarations 

LANGUAGE:  VAX- 11  COBOL 

DESCRIPTION: 

IDENTIFICATION:  APPDEF 
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UI  SERVICES  Include  File  Description 


FILE  NAME:  CICODE 

PURPOSE:  Command  Interpreter  CODES 

LANGUAGE:  VAX- 11  COBOL 

DESCRIPTION: 


IDENTIFICATION:  CICODE 
DESCRIPTION: 

THESE  ARE  COMMAND  INTERPRETER  CODES. 
INFORMATION : 

TYPE:  (C-COBOL,  I C -COBOL  COPY)  IC 
SUBSYSTEM:  UI-CI 
CONFIGURATION  ITEM  ID: 

DESIGNED  BY:  S.  L.  BARKER 
START  DATE:  1/18/83 
FINISH  DATE:  1/18/83 

PROGRAMMED  BY:  S.  L.  BARKER 
START  DATE:  1/18/83 
FINISH  DATE:  1/18/83 


I 


UPDATED  8/24/83  TO  COMBINE  WITH  UICODE . INC 
UPDATED  8/25/83  TO  ACCOMMODATE  NEW  MESSAGE  LINE  CODE 
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UI  SERVICES  Include  File  Description 


FILE  NAME:  CURSORI 

PURPOSE:  CURSOR  description 

LANGUAGE :  VAX- 1 1  COBOL 

DESCRIPTION: 


IDENTIFICATION:  CURSOR 
DESCRIPTION: 

THIS  IS  THE  ORACLE  CURSOR  DESCRIPTION. 
INFORMATION: 

TYPE:  (C-COBOL.  IC-COBOL  COPY)  IC 
SUBSYSTEM:  UI 
CONFIGURATION  ITEM  ID: 

DESIGNED  BY:  S.  L.  BARKER 
START  DATE:  1/24/83 
FINISH  DATE:  1/24/83 

PROGRAMMED  BY:  S.  L.  BARKER 
START  DATE:  1/24/83 
FINISH  DATE:  1/24/83 
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UI  SERVICES  Include  File  Description 


FILE  NAME:  DBNAME 

PURPOSE:  DataBase  field  NAMES 

LANGUAGE:  VAX- 11  COBOL 

DESCRIPTION: 


IDENTIFICATION:  DBNAME 
DESCRIPTION: 

THIS  DESCRIBES  THE  ORACLE  DATABASE  ID  FIELDS. 
INFORMATION : 

TYPE:  (C-COBOL.  I C -COBOL  COPY)  IC 
SUBSYSTEM:  UI 
CONFIGURATION  ITEM  ID: 

DESIGNED  BY:  S.  L.  BARKER 
START  DATE:  1/17/83 
FINISH  DATE:  1/17/83 

PROGRAMMED  BY:  S.  L.  BARKER 
START  DATE:  1/17/83 
FINISH  DATE:  1/24/83 
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UI  SERVICES  Include  File  Description 


FILE  NAME:  DEFCOM 

PURPOSE:  DEFCOM  data  del  carat  ions 

LANGUAGE:  VAX- 11  COBOL 

DESCRIPTION: 


IDENTIFICATION:  DEFCOM 

DESCRIPTION:  THESE  ARE  THE  DATA  DECLARATIONS  FOR  THE 
DEFCOM  FORM. 

INFORMATION: 

TYPE:  (C-COBOL,  IC-COBOL  COPY)  IC 
SUBSYSTEM:  UI-CI 
CONFIGURATION  ITEM  ID: 

DESIGNED  BY:  S.  L.  BARKER 
START  DATE:  2/25/83 
FINISH  DATE.  2/25/83 

PROGRAMMED  BY :  S  L .  BARKER 
START  DATE:  2/25/83 
FINISH  DATE:  2/25/83 


V 

V 
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U1  SERVICES  Include  File  Description 


FILE  NAME:  DEFINE 

PURPOSE:  DEFINE  form  data  declarations 

LANGUAGE:  VAX- 11  COBOL 

DESCRIPTION: 
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UI  SERVICES  Include  File  Description 


FILE  NAME:  FPCODE 

PURPOSE:  FORM  PROCESSOR  RETURN  CODES 

LANGUAGE :  C 

DESCRIPTION: 
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U1  SERVICES  Include  File  Description 


FILE  NAME:  FPD 

PURPOSE:  FORM  PROCESSOR  DATA 

LANGUAGE :  C 

DESCRIPTION: 


DESCRIPTION 

DATA  DEFINITIONS  FOR  ALL  FORM  PROCESSOR  (INCLUDING 

MON I TER) DATA. 
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UI  SERVICES  Include  File  Description 
FILE  NAME:  FPEMSG 

PURPOSE:  FORM  PROCESSOR  ERROR  MESSAGES 

LANGUAGE :  C 

DESCRIPTION: 

DESCRIPTION 
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UI  SERVICES  Include  File  Description 


FILE  NAME:  FPPARM 

PURPOSE:  FORM  PROCESSOR  PARAMETERS 

LANGUAGE :  C 

DESCRIPTION: 


DESCRIPTION:  THESE  DATA  DEFINITIONS  ARE  USED 
IN  THE  FORM  PROCESSOR  ROUTINES. 
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UI  SERVICES  Include  File  Description 


FILE  NAME:  LDAI 

PURPOSE:  oracle  Logon  Data  Area  description 

LANGUAGE:  VAX- 11  COBOL 

DESCRIPTION: 


DESCRIPTION: 

THIS  IS  THE  DESCRIPTION  OF  THE  ORACLE  LOGON  DATA  AREA. 
INFORMATION: 

TYPE:  (C-COBOL,  IC-COBOL  COPY)  IC 
SUBSYSTEM:  UI 
CONFIGURATION  ITEM  ID: 
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UI  SERVICES  Include  File  Description 


FILE  NAME:  NTM 

PURPOSE:  NTM  INTERFACE  INCLUDE  FILE 

LANGUAGE :  C 

DESCRIPTION: 


DESCRIPTION 

INCLUDE  FILE  FOR  NTM  INTERFACE 
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UI  SERVICES  Include  File  Description 


FILE  NAME:  ORACLE 

PURPOSE:  data  delcarations  for  programs  that  access  ORACLE 

LANGUAGE:  VAX- 11  COBOL 

DESCRIPTION: 


DESCRIPTION: 

THESE  ARE  DATA  DECLARATIONS  THAT  ARE  COMMONLY  USED 
IN  PROGRAMS  THAT  ACCESS  ORACLE. 

INFORMATION : 

TYPE:  (C-COBOL,  IC-COBOL  COPY)  IC 
SUBSYSTEM:  UI 
CONFIGURATION  ITEM  ID: 

DESIGNED  BY:  S.  L.  BARKER 
START  DATE:  1/17/83 
FINISH  DATE:  1/17/83 

PROGRAMMED  BY:  S.  L.  BARKER 
START  DATE:  1/17/83 
FINISH  DATE:  1/24/83 
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UI  SERVICES  Include  File  Description 


FILE  NAME:  ORCODE 
PURPOSE:  ORacle  CODES 

LANGUAGE:  VAX- 11  COBOL 

DESCRIPTION: 


DESCRIPTION: 

THESE  ARE  COMMONLY  PASSED  ORACLE  CODES . 

INFORMATION : 

TYPE:  (C-COBOL.  IC-COBOL  COPY)  IC 
SUBSYSTEM:  UI 
CONFIGURATION  ITEM  ID: 

DESIGNED  BY:  S.  L.  BARKER 
START  DATE:  1/18/83 
FINISH  DATE:  1/18/83 

PROGRAMMED  BY:  S.  L.  BARKER 
START  DATE:  1/18/83 
FINISH  DATE:  1/18/83 

UPDATED  8/25/83  TO  ACCOMMODATE  NEW  MESSAGE  LINE  CODE 


ORACLE  ERROR 
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UI  SERVICES  Include  File  Description 


FILE  NAME  PSWORDI 

PURPOSE  PaaSWORD  form  data  structure 
LANGUAGE  VAX - 1 1  COBOL 

DESCRIPTION 


DESCRIPTION  THIS  IS  THE  DATA  STRUCTURE  FOR  THE  PSWORD  FORM 
INFORMATION 

TYPE  (C-COBOL.  I C -COBOL  COPY)  IC 
SUBSYSTEM  UI 
CONFIGURATION  ITEM  ID: 

DESIGNED  BY: 

START  DATE 
FINISH  DATE 

PROGRAMMED  BY  S  L  BARKER 
START  DATE  1  20 '83 
FINISH  DATE  1  20  83 
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UI  SERVICES  Include  File  Description 


FILE  NAME:  SRVRET 

PURPOSE:  AS  THE  RETURN  GIVEN  A  TABLE-FULL  ERROR 

LANGUAGE:  VAX- 11  COBOL 

DESCRIPTION: 


MODIFIED  11/2/83  TO  INCLUDE  RET-CODE-5 

MODIFIED  1/9/84  TO  INCREASE  ALL  ERROR  CODES  TO  PIC  X(5) 
AND  TO  ELIMINATE  ALPHA'S 

MODIFIED  1/26/84  TO  ADD  RET-CODE  FOR  GETUSR-NOT-S'JCC 
SRV- SUCCESSFUL  ADDED  FOR  GENERIC  RETURN 
MODIFIED  2/7/84  TO  ADD  ERROR  CODES  FOR  ENTRY -NOT -FOUND 
MODIFIED  2/8/84  TO  ADD  WHTHST-NOT-SUCCESSFUL 
MODIFIED  2/20/84  TO  ADD  TSTMOD  NEW  CODES. 
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UI  SERVICES  Include  File  Description 


FILE  NAME:  STDTYP 

PURPOSE:  STANDARD  TYPE  DEFINITIONS 

LANGUAGE :  C 

DESCRIPTION: 


DESCRIPTION 

THIS  FILE  ENSURES  THAT  THE  FOLLOWING  STANDARD  TYPES  ARE 

AVAILABLE : 

FLOAT  -  SINGLE  PRECISION  FLOAT 

DOUBLE  -  DOUBLE  PRECISION  FLOAT 

LONG  -  32  BIT  (OR  LARGER)  SIGNED  INTEGER 

LBITS  -  32  BITS  (OR  MORE)  FOR  BIT  MANIPULATION 

I NT  -  NATURAL  SIZE  SIGNED  INTEGER 

UNSIGNED  -  NATURAL  SIZE  UNSIGNED  INTEGER 

BOOL  -  NATURAL  SIZE  LOGICAL  (ZERO  '  NON-ZERO  ONLY) 

SHORT  -  16  BIT  (OR  LARGER)  SIGNED  INTEGER 

USHORT  -  16  BIT  (OR  LARGER)  UNSIGNED  INTEGER 

BITS  -  16  BITS  (OR  MORE)  FOR  BIT  MANIPULATION 

CHAR  -  SINGLE  MACHINE  CHARACTER  (REAL  CHARACTERS 

ALWAYS  POSITIVE) 

TINY  -  8  BIT  (OR  LARGER)  SIGNED  INTEGER 

UTINY  -  8  BIT  (OR  LARGER)  UNSIGNED  INTEGER 

TBITS  -  8  BITS  (OR  MORE)  FOR  BIT  MANIPULATION 
TBOOL  -  8  BIT  (OR  LARGER)  LOGICAL  (ZERO  NON -ZERO 
ONLY  ) 

METACHAR  -  16  BIT  (OR  LARGER)  AUGMENTED  CHARACTER 

( SIGNED  > 

VOID  FUNCTION  THAT  RETURNS  NO  VALUE 

FORTRAN  STORAGE  CLASS  FOR  FOREIGN  (NON  C)  ROUTINES 

OR  C  ROUTINES 

WHICH  ARE  CALLABLE  FROM  FOREIGN  ROUTINES 

SINCE  NOT  ALL  COMPILERS  SUPPORT  USHORT.  TINY  AND  UTINY 

THE  FUNCTIONS 
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USHORTl  )  .  TINY (  )  .  AND  UTINY(  )  SHOULD  BE  USED  WHENEVER 

REFERENCING  THEM 

IN  ADDITION.  THE  FOLLOWING  UTILITY  MACROS  ARE  DEFINED: 
LURSHIFT( N ,  B)  -  UNSIGNED  LONG  RIGHT  SHIFT 
MAX( A .  B)  -  MAXIMUM  OF  A  AND  B 

MIN( A ,  B)  -  MINIMUM  OF  A  AND  B 


PS  620144100 
1  November  1985 


UI  SERVICES  Include  File  Description 


ABS(A)  -  ABSOLUTE  VALUE  OF  A 

STRASN( A ,  B)  -  TRANSPORTABLE  A  =  B  FOR  STRUCTURES 

NULL  -  NULL  POINTER  VALUE  (0) 

TRUE  -  1 

FALSE  -  0 

SUCCESS  -  EXIT( SUCCESS)  INDICATES  SUCCESSFUL 

COMPLETION 

FAILURE  -  EXIT( FAILURE)  INDICATES  ERRORS 

THE  FOLLOWING  SYMBOLS  SHOULD  BE  DEFINED  BASED  ON  THE 

COMPILER  BEING  USED: 

USHORT  -  COMPILER  SUPPORTS  UNSIGNED  SHORT 
TINY  -  COMPILER  TREATS  CHAR  AS  SIGNED 
UTINY  -  CHAR  IS  SIGNED  AND  COMPILER  SUPPORTS 
UNSIGNED  CHAR 

VOID  -  COMPILER  SUPPORTS  VOID 
FORTRAN  -  COMPILER  SUPPORTS  FORTRAN 
STRASN  -  DEFINE  APPROPRIATE  MACRO 
SUCCESS  -  DEFINE  APPROPRIATE  VALUE  IF  NOT  0 
FAILURE  -  DEFINE  APPROPRIATE  VALUE  IF  NOT  1 
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U1  SERVICES  Include  File  Description 


FILE  NAME:  UPDCOM 

PURPOSE:  UPDate  COMmand  form  data  declarations 

LANGUAGE:  VAX- 11  COBOL 

DESCRIPTION: 


DESCRIPTION:  THESE  ARE  THE  DATA  DECLARATIONS  FOR  THE 
UPDATE  COMMAND  (UPDCOM)  FORM. 

INFORMATION: 

TYPE:  (C-COBOL,  IC-COBOL  COPY)  IC 
SUBSYSTEM:  UI-CI 
CONFIGURATION  ITEM  ID: 

DESIGNED  BY:  S.  L.  BARKER 
START  DATE:  2/25/83 
FINISH  DATE:  2/25/83 


PROGRAMMED  BY:  S.  L.  BARKER 
START  DATE:  2/25/83 
FINISH  DATE:  2/25/83 
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3.10.10  Hierarchy  Chart 

The  following  hierarchy  charts  show  the  relationships 
between  all  of  the  modules  mentioned  in  the  above  documentation. 
A  module  may  call  a  subroutine  several  times  within  its  code, 
but  the  call  will  only  be  shown  once  as  a  single  relationship  on 
this  hierarchy  chart.  All  modules  shown  at  the  top  of  the  first 
page  are  considered  Main  Programs  as  described  in  section  3.10.1 
above . 

There  l s  an  internal  paging  scheme  as  marked  by  the  numbers 
in  the  upper  right  corner  of  each  page.  An  index  after  the  last 
page  of  the  chart  shows  where  a  routine  and  its  calls  are  first 
defined.  If  a  routine  has  no  page  reference,  it  either  makes  no 
calls  or  is  an  external  routine.  A  continuation  box  on  the  end 
of  a  tree  limb  shows  where  that  the  tree  continues  on  the  page 
numbered  mentioned.  A  number  in  a  box  with  a  routine  name 
points  to  the  page  where  the  routine  is  further  defined  within 
the  hierarchy  tree.  If  there  is  no  number  in  a  box,  the  routine 
either  makes  no  calls  or  is  an  external  routine. 
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l 


I0SQL3I  IOBINDI  lOEXECl  lODFINNI  lOPETCHl 


+ - + 

I DBCUPR I 
+--+ - + 

I 

+ - + - + - + 

III  I 
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I INCGEN/MAIN I 
+ - + - + 


PRINTF l 


’  I  I  GETS  I  I 
-+  + - +  + 


FOPENI  IFEOFI  I FREAD I  I (CONT) I 
- +  + - +  + - +  + - 6+ 


ftjKl 
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I  INITAL I  I MEMCMP I 
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5 

- +  + - +  + - +  + - + 

( CONT ) I  I  PROCAP  I  I PROCDF I  I PROCPW I 

- 1+  + - 8+  + - 9+  +  —  + - + 

I 

+ - + - + - + - + - + - + 

l  I  I  I  I  I 

+  --  + - +  +  --  + - +  +  --+ - +  +--  + - +  +--+ - +  +  --+ - + 

I INITAL I  I 1NITFP I  ITERMFPI  I TRMNAT I  I DBOPEN I  I (CONT) I 

+ - +  + - +  + - +  + - +  + - 9+  + - 10+ 
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IMM/MAIN i 

+ - + - + 


( CONT ) l 

- 4  + 


I  MM/NEWFILE I  I MEMCPY I  IKM/SAVEITI  I (CONT) l 
y - 11+  + - +  + - + - +  + - 12  + 


IFCLOSEI  IFWRITEI  l MEMCMP I  I FOPEN l 
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4 - - 

I 

-  -  4 - 4 

INITAL i 


♦  --  + - + 

i INITFP i 


- 4_ . 

i 

4  -  -4 - 4 

ITERMFP i 


4 - 4 

l PROCDF i 

4 - 4 - 4 

I 


■  4- 

I 


4 - 4 - 4 

I TRWNAT l 


4 - 4 - 4 


I DBOPEN i  l ( CONT ) 
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PROCPW 


+  —  ♦ - + 


i ( CONT  )  i 


+  —  ♦ - + 

lOPNFRM i 


+  —  * - + 

i ADDFRM i 


+  —  +  — 

i 01  SCR i 


i GDATA i 


-5* 


i  ( COMT  ) 

-*■ - 14  + 


1  14 
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1 1 


i MM  NEWFILE i 

+ - + - + 

i 

♦ - - + - + - + - 

i  i  i 

-*• —  +  —  +  - f +  —  + +  +  —  -t + 

i PDATA  i MEMCPY I  i FCLOSE i  I FREAD l 

- +  + - - +  4 - +  + - + 


I 

+--+--+ 

l FOPEN I 

+ - + 


+ 

I 


+  --  + - + 

l ( CONT ) l 
+ 15  + 
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i  >v* 
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+ - + 

I MM/NEWFILE I 

+ - + - + 

I 

I  I 

K--  + - +  + - + - + 

I  ( CONT ) I  I SPRINTF I 

b - 11+  + - + 


- + 

I 

+  --+ + 

I MEHSET I 
+ - + 
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+ 


f--  + - + 

I  (CONT) l 
+ - 12+ 


+ - + 

I  MM/MAIN  I 

+ - + - + 

I 

- + - + - + - + 

I  I  I 

+  --+ - +  +--  + - +  +--+ - + 

ITRMNATI  I INITFP I  lOPNFRMl 
+ - +  + - +  + - + 
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+  --  + - + 

l  (CONT) I 
+ - 13+ 


17 

+ - + 

I PROCDF t 

+  --  + - + 

I 

- + - + - + - + - + - + 

I  I  I  I  I 

+  --  + - +  +--+--+  +  --  + - +  +--+ - +  +--+ - + 

I PMSGLS !  I GDATA I  I DBGAPD I  I PROCDC I  I ( CONT ) I 
+ - +  + - +  + - 8+  + - 19+  + - 20+ 
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18 

+ - + 

I PROCPW I 

+  --  + - + 

i 

+ - + - + 

I  I  I 

+ — + - +  +--  + - +  +--+ - + 

I  (CONT) I  ICLSFRMI  I DBCLSE I 
+ - 14+  + - +  + - 20+ 
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I ADDFRM I  I PDATA ! 
+ - +  + - + 
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I PROCDF I 
+  --  + - + 


+  --  + +  +  --  + + 

l (CONT) I  IPROCUCI 
+ - 17+  + - 21  + 


- +__  +  +--+ - 


I GPAGE 


I RMVPAG I 


+  —  + - +  + — + - + 

I CLSFRM l  I DBCLSE I 
+ - +  +--+ + 


+  --  + - + 

I OLOGOF I 
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l PROCUC i 


- + - +  +  --  + - +  +  --  + - + 

(CONT)i  l DBDAPP i  ! DBDAPR I 
■ - 21+  + - 23+  + - -  -24  + 


l DBROLL I 
+  __  + - + 


+  --  + - + 

iDBUAPDi 
+ 25  + 


i OROL i 
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i DBDAPP i 

+  —  - + 
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i  i  i 

i 0SQL3 i  lOBINDl  lOEXECl 
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I DBDAPR l 
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+  - 
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I 

iOBINDl 
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- + 

l 

IOEXECI 
+ - + 
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+ - 4- - h 

l OSQL3 i 

4- - 4 


4- - 4 

i DBUAPD i 

4 - 4 - 4 

I 

- + - 4 

I  I 

4 - 4 - 4  4 - 4 - 4 

lOBINDl  lOEXECi 

4 - 4  4 - 4 
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ADDFRM 

PRINTF 

CLSFRM 

PROCAP  .... 

....  8 

DBCLSE  .  .  .  . 

. . . .20 

PROCDC .... 

...  19 

DBCOM . 

. 8 

PROCDF .... 

...  .9 

DBCUPR 

. 2 

PROCPW .... 

...  .5 

DBDAPP  .  .  .  . 

.  .  .  .23 

PROCUC .... 

...  21 

DBDAPR  . 

....  24 

RMVPAG 

DBGAPD  . . 

. 8 

SPRINTF 

DBGAPP .  .  .  . 

. 1 

TERMFP 

DBIAPD. . . . 

....  19 

TRMNAT 

DBOPEN  .  . 

. 9 

DBROLL  .  .  . 

. . . .22 

DBUAPD 

.. . .25 

DBUPV . 

...  14 

FCLOSE 

FEOF 

FOPEN 

FPRINTF 

FREAD 

FWRITE 

GDATA 

GETCHAR 

GETS 

GPAGE 

INCGEN  MAIN  .  .  .  .  3 


INITAL 

INITFP 

MEMCMP 

MEMCPY 

MEMSET 

MM  MAIN . 4 

MM  NEWFILE .  ...  11 
MM  SAVEIT . 7 


OBIND 

OCOM 

ODFINN 

OEXEC 

OFETCH 

01  SCR 

OLOGOF 

OLON 

OOPEN 

OPNFRM 

OROL 

0SQL3 

PDATA 

PMSGLS 
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3  11  Program  List  ings  Comments 

This  information  is  contained  in  the  Module  Descriptions  in 
sect  ion  3.10. 
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SECTION  4 

QUALITY  ASSURANCE  PROVISIONS 


41  Introduction  and  Definitions 


“Testing"  is  a  systematic  process  that  may  be  preplanned 
and  explicitly  stated.  Test  techniques  and  procedures  may  be 
defined  in  advance .  and  a  sequence  of  test  steps  may  be 
specified  "Debugging"  is  the  process  of  isolation  and 
correction  of  the  cause  of  an  error. 

" Ant ibugging"  is  defined  as  the  philosophy  of  writing 
programs  in  such  a  way  as  to  make  bugs  less  likely  to  occur  and 
when  they  do  occur,  to  make  them  more  noticeable  to  the 
programmer  and  the  user.  In  other  words,  as  much  error  checking 
as  is  practical  and  possible  in  each  routine  should  be 
performed . 

4  2  Computer  Programming  Test  and  Evaluation 

The  quality  assurance  provisions  for  test  consists  of  the 
normal  testing  techniques  that  are  accomplished  during  the 
construction  process.  They  consist  of  design  and  code 
walk-throughs,  unit  testing,  and  integration  testing.  These 
tests  are  performed  by  the  design  team.  Structured  design, 
design  walk-through  and  the  incorporation  of  "antibugging" 
facilitate  this  testing  by  exposing  and  addressing  problem  areas 
before  they  become  coded  "bugs." 


